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Life is good at InstallShield. We’ne located just outside 
Chicago. Which means that the pizza here is great. 
And by and large, most everyone is nice to work with. 

Aside from being a pretty unique collection of 
characters, we're also the world leader in tools for 
enabling software deployment to all Windows platforms. 
Our products are used to distribute hundreds of 
world-class applications: Intuits Quicken, Netscape 
Navigator Borland’s Delphi, Microsoft's Front Page... 
you get the idea. 

If someday you join us, you’ll find that you'll be 
challenged. (Quite frankly, we don’t have time for 
brain-numbing "filler”.) And the kinds of things you 
create will be seen and used around the world. 

Here are a few adjectives used to describe the 
people we're looking for: creative, aggressive, smart, 
entrepreneurial. If you're interested in any of the positions 
listed below and feel that you can favorably impact our 
future, take a minute to visit our web site. If you like 
what you see, send your resume and salary requirements 
via email: jobs@installshield.com. Dorks need not apply 
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Whether you’re in sales, marketing or development, demo-it! will show off your product when 
you’re not there. Need to give away demos at your upcoming trade show? Need to post demos 
on the Internet? Well now you can, with demo-it! 


No time to learn an authoring tool? No problem! 

You need to create a demo to show off your software, and you need 
it yesterday. You don’t have time to learn an authoring tool—all you 
want is to create an effective sales tool. Since demo-it! requires NO 
programming, has great on-line help and informative documentation, 
you can create a professional-looking demo quickly. 


Whatever kind of demo you want is what you get with demo-it! 

Quickly put together sales presentations. Produce electronic brochures for potential customers. Create 
self-running demos. Upload an interactive demo to the Internet. Supply your in-house staff with tutorials. 
Promote sales with disk-based advertising. 


Just look at some of the features: 

Version 2.0 of demo-it! is even more feature-rich than the best-selling Version 1.0. 
■ Enhanced special effects, including Implode and Explode ^ 
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Is completely WYSIWYG—no need for you to worry about font support 
Works great on disk, CD-ROMS, Internet and on-line services 
Launches external programs 

Has rich text support—use several fonts and styles in one object 
Supports variables and conditions 
Creates a familiar “slide show” about your product 
Text, lines, buttons, pictures, rectangles, slides, overlays & underlays are easily created 
Supports events 

Has actions such as next slide, previous slide, go to slide, play a .WAV file, run a program, etc 
Has a screen capture utility with many features 

Runs demos direcdy from floppy disk—no need for users to change their hard drives 
Comes with a freely distributable 170K run-time player 
Creates small, compact demos. 
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CALL & ORDER TODAY! 

800 * 987*4929 
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What does Plug and Play mean for programmers, and how does it handle the many 
existing ISA cards? This article shows you how it all fits together and includes example 
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Tilakraj Roychoudhury and Lee Woon Jeong 

Using the Task Tray from VB. 19 

The Windows 95 task tray is a handy place to display status information or icons repre¬ 
senting background tasks. To put your own icon in the task tray, you have to use the 
new shell API. This article shows how to do the trick from Visual Basic 4.0. 
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Displaying a Window in Full-Screen Mode . 27 

Screen real estate is always scarce, and that’s why some tasks (such as print preview¬ 
ing) benefit from a full-screen mode. Here's a description of the problem, along with 
reusable code for implementing full-screen mode in your own applications. 

V. Ramachandran 

A Technique for Fast MFC Compilation. 31 

Including the required header files for your MFC project can be a pain, but if you just 
include everything under the sun, your compile speed will quickly get slow. Here’s an 
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use SetThreadPri ori ty() at runtime to control which thread will execute next? Don’t NT 
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From the Editor 



Let's face it - when you need a disassem¬ 
bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov ax,2517h 

mov dx .offset int_17h_entry 

int 21 h : 

mov dx.offset data_4 
mov ah ,9 
int 21 h 


mov dx,19h 
mov ah,31h 


DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 
; ('Halt when ? printed.') 

: DOS Services ah=function 09h 
; display char string at ds:dx 

: DOS Services ah=function 31 h 
; terminate and stay resident 
; al=retum code,dx=paragraphs 


int_17h_entry proc 
pushf 


; Push flags 


Partial Disassembly of a Virus 

C/C++and Pascal 

Some C, C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can’t change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_l 0_video”. And it's fully automatic. 
Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs, VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls, 
API calls like "GetModuIeHandle", undocu¬ 
mented APIs, VxD functions and much more. 

Call now! 
1-800-648-8266 

Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 

Shipping: USA $6; Canada/Mexico $10; All others $25. 

CA residents add sales tax. © 1994 VISA/MC/Amex/COD 

30-DAY MONEY-BACK GUARANTEE 
V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 120-WD 
San Jose, CA 95129 408-296-4224 
FAX 408-296-4441 


a 



At long last, you can order our back issues on CD-ROM! For $49.95 (plus S&H), 
you get all the issues from December 1991 through December 1995, along with a 
full-text search engine. The search engine will be updated with bug fixes and new 
features, so if you buy the CD-ROM, check our Web site (www. wd j . com) to make 
sure you have the latest and greatest version of the search engine. To order, call 
(800) 444-4881 (outside the U.S. call (913) 841-1631 or send email to 
orders@mf i . com) with credit card in hand. Alternatively, just hop over to 
www .wdj.com and order directly from there. AT The idea of automatically proving 
the correctness of software is dead, right? Not so fast — the January 1996 issue of 
Journal of the ACM has an article by Boyer and Yu that reveals they have produced 
automated proofs of 21 functions in the Standard C library. But the kicker is that 
they performed these proofs on the MC68020 object code, not on the original 
high-level source code. Consider the value of finding not only your bugs, but any 
compiler bugs as well — maybe automated software proofs really will make it into 
mainstream programming someday. The authors note that one future use could be 
for verifying the output of compilers, but feel that application "may have little 
practical interest in the near future". I disagree. I think some companies would pay 
big bucks to be able to automatically check for compiler bugs just before ship¬ 
ping. AT It's widely known that a great many attempts to log on to MSN fail, and 
I reported here the fact that MSN is losing around 90 percent of incoming Usenet 
news (Microsoft doesn't know when either problem might be fixed). But now my 
MSN out-of-box experience has a new wrinkle. My login started failing recently 
due to "invalid account or password". After a couple of tech support calls, I was 
told "sometimes a password gets garbled", and they fixed the problem by assign¬ 
ing me a new password. And CompuServe is turning to Microsoft for software — 
what are they thinking? AT Lots of readers responded to my complaint about the 
worthless new Windows key (the one with the funny Windows logo on it) on new 
keyboards. The best tip came first from Neil Sandlin: you can press Windows-M to 
minimize all your windows, and Windows-Shift-M to restore them all to their pre¬ 
vious state. There are other shortcuts, but this is the only one that's making me use 
the new Windows key on a regular basis. AT I've said it before, but I'll say it 
again: lots of buggy Win32 apps are being written due to lack of understanding 
of threads. Whether you're using Win95 or NT, read this month's "Understanding 
NT" column and make sure you're not a victim of some of the common myths 
about how thread scheduling works. You'll also find the differences between NT 
and Win95 scheduling surprising. AT By popular demand, this column now has a 
bigger font (though fewer tidbits of information). 

Ron Burk 

Editor 

70302.2566@compuserve.com 

http: / / ourworld.compuserve.com/homepages/RonBurk 


Drop in on our Web site! 
You’ll find us at: 

http://www.wdj.com 


You’ll find information and 
excerpts from the current 
issue, along with links to 
WDJ code, including our 
SDK Annotations. 

Check it out — and let us 
know what you think. 
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Visual Internet Toolkit 


Save months of TCP/IP programming! 


Fill in properties 



■+: * 

* * * Write a little code 




Object jComroandl jjjj Ploc. jciick jj[] 

; Private Sub Con*nandl_Clic)cO |j 

' Connect to the FTP Server 
FTPClient.Action - ACTION_CONNECT 
1 Transfer Remote File to your machine 
FTPClient.FileAction - FILE_ACTION_GET —* 



OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 


Protocols 

• Windows Sockets 

• Telnet 

• TCP/UDP/ICMP 

• VT 220 

• PPP/SLIP/CSLIP 

• WinSNMP 

• E-mail/SMTP 

• ONC RPC/XDR 

•POP 2/POP 3 

• rep 

• News/NNTP 

• rexec 

•FTP 

• rlogin 

•TFTP 

• rsh 

• TCP Server 

• And many more 

Interfaces* 

Environments 

•32 bit (95 and NT) 

• Visual Basic 

• 16 bit (Windows 3.x) 

• Visual C/C++ 

• C++ Class libraries 

• Delphi 

• DLL’s 

• C/C++ 

• OCX’s 

• Access 

• VBX’s 

• FoxPro 


32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation. 
Which makes your job easier and leaves the 
competition in the dust. 

{ Call now for JL. 

30 minute 
Internet m " ) 
Delivery! t ■ 

//I 

Jk . 

distinct 


The u orld leader in Internet development tools. 


u 408.366.8933 

World Wide Web: http://www.distinct.com 
Fax: 408.366.0153 

E-mail: windev@distinct.com 

Fastfacts: 408.366.2101 


*Noi al inieifxxs may be for all protocols. Licensing fees required for redistribuUon. Disdncl is a registered iradmark and 30 minute Iniemei Delivenl and Visual Internet is a trademark of die Distina Corporabon. Copyright 1995 Disdna Corporation. 12900 Saratoga Avenue, Saratoga, CA 95070. All r^its reserved. Specifications smd delrvm terms are subject to chaise without notice. 
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The Inside Story of ISA 
Plug And Play 

Tilakraj Roychoudhury and Lee Woon Jeong 


Plug and Play was designed to let the user plug in a new piece of hardware with¬ 
out having to worry about I/O ports, IRQs, DMA channels, and memory settings. 
The system should handle the hardware configuration, allocating the resources it 
needs and arbitrating any conflicts with other devices. This requires Plug and Play 
hardware to be more intelligent than traditional PC peripherals by supporting a par¬ 
ticular protocol that the operating system can use to communicate with the device. 
This article provides an overview of Plug and Play in general, then provides the 
source to a sample utility that demonstrates some of the details of the Plug and Play 
protocol. 

Plug and Play is a relatively new standard for peripheral hardware defined joint¬ 
ly by Intel, Microsoft, Phoenix, and Compaq. A Plug and Play (PnP) card can con¬ 
verse with the system using the PnP protocol only, and hence remains completely 
nonfunctional until someone uses the PnP protocol to configure it. Having a PnP 
card on the ISA bus is not adequate. You need a software module that speaks the PnP 
protocol and can also deal with the non-PnP (legacy) cards on the ISA bus. This 
enables the module to handle various problems, such as a legacy card using an inter¬ 
rupt that a PnP card is requesting. This software component, which we refer to as the 
"system configurator," is provided by a number of vendors in different forms; Intel 
provides a DOS device driver (dwcfgmg . sys), Microsoft bundles a PnP VxD (conf i g- 
mg. vxd) as an integral part of Windows 95, and many vendors supply PnP BIOSs to 
motherboard manufacturers. 

The PnP architecture, shown in Figure 1, is fairly simple. A PnP card stores its 
resource requirements in an on-board EPROM. The system configurator queries 
each PnP card for its resource requirements by using the PnP protocol to read its 
EPROM data. The system configurator then retrieves the configuration information 
pertaining to all legacy cards in the system (from sources discussed later) and com¬ 
putes resource usage to work out a conflict-free resource allocation for the PnP cards. 

How does the BIOS or PnP driver know whether or not a particular resource (1/O 
port, IRQ, etc.) is being used by a legacy card? The ISA Configuration Utility (ICU) 
provides this information. ICU is an interactive utility that allows the user to select 
all the resources that are used by the legacy cards present in the system and store 


Tilakraj Roychoudhury is a Senior Software Engineer with Philips Semiconductors, 
TriMedia Product Group, where he works on realtime operating systems and multimedia 
device drivers for Windows 95 and NT. He can be reached at 102734.1014@com- 
puserve.com. 

Woon Jeong Lee is a Laptop Bios Engineer for Compaq Asia. He holds a Computer 
Engineering degree from Nanyang Technological University, Singapore. He can be con¬ 
tacted at wjlee@bangate.compaq.com. 
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Is your installer missing 
a few pieces? 




The Wise Installation System 4.0 


The Wise Installation System is a Windows based installation editor that creates 
professional setup programs in hours, not days. It creates a single installation that runs in 
Windows 3. lx, Windows NT™ or Windows 95®. It comes complete with both Winl6 and 
Win32 versions, creates shortcuts/shell links for use with Windows 95, handles nested 
components and has a full uninstaller. It is completely customizable to fit your needs. 
Order now and stop looking for that missing piece! 



Business Solutions 




To order call 1-800-554-8565 
or use http://www.glbs.com 

to download a fully functional demo. 
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them for purposes of resource management. For systems with 
a PnP BIOS, the ICU stores this configuration information in 
the NVRAM; otherwise, this information resides in a file 
called escd.rf (extended static configuration data reference 
file). Under Win95, the System Detection Modules (SDMs) 
take over the functionality of the ICU and store the legacy card 
resource usage in the Win95 registry, which is added during 
OS installation or upon running the "Add New Hardware" 
applet. Each time the system boots, the system configurator 
refers to these information repositories to retrieve information 
about resources that are currently occupied by the legacy 
cards. In this way, the system configurator ensures that 
resources already allocated to legacy devices will not be allo¬ 
cated to PnP devices. 


Windows 95 
configmg.vxd 


Windows 3.1/DOS 
dwcfgmg.sys 


Plug and Play BIOS 
Plug and Play Hardware 


F i g U re 1 Plug and Play system configuration 

software architecture 


+ fan 'T/CP 


MFC extension class library implements embeddable 
dialog editor / GUI builder. OHyperView-H- combines f i JQ5 
the power of Visual C++ with the ease of Visual Basic! In' 
Make OLE automation easy via built-in Basic scripting. 

♦ Embed a custom view / dialog editor into your application 

♦ Build your GUI visually at run time without recompilation 
■^Define your data. ‘PDefine your GUI objects and controls. 
Connect them together at run time with unlimited flexibility! 
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A single PC might have more than one PnP system config¬ 
urator, and if so, they must work together. For instance, con¬ 
sider a system with a PnP BIOS running Win95. When the 
machine boots, the BIOS configures the PnP cards necessary 
for booting the machine. Then, as Windows 95 starts up, the 
system configurator (which in this case is configmg.vxd) 
retrieves PnP device information about cards that have been 
configured by the BIOS through documented BIOS calls. 
When configuring the other (non-boot) PnP devices in the sys¬ 
tem, confi gmg. vxd refrains from allocating those resources that 
have already been assigned by the BIOS to the boot devices. 
Figure 2 shows the different components that comprise the 
Plug and Play subsystem. 

PnP Ports 

The system configurator identifies and configures devices 
via commands sent to three 8-bit I/O ports, namely the 
ADDRESS port (0279h, printer status port), WRITE_DATA port 
(0A79h, printer status port + 0800h) and READ_DATA port (relocat¬ 
able in range 0203h to 03FFh). The READ_DATA port is selected 
during the configuration process. Figure 3 shows the state dia¬ 
gram of the PnP configuration. The configuration process will 
be explained in more detail later. 

Initiation 

All PnP cards on the bus are in the WaitForKey state after 
a hot or cold system boot or in response to the Reset or 
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Figure 2 Plug and Play component interac¬ 
tion 
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Wai tForKey commands. The PnP cards do not respond to any 
command until they have detected the initiation key on the 
ISA bus. The initiation key is a sequence of 32 bytes of data 
sent to the ISA bus through the ADDRESS port. The initiation 
key sequence is generated by the system configurator using 


Figure 4 Plug and Play initiation key 
sequence 


i* . 

EnterSleepMode 

This function enables all the PnP cards on the ISA Bus by 
sending the Initiation Key Sequence to the Universal ISA-PnP 
Address Port. 

. */ 

void EnterSleepMode(void) 

( 

unsigned short wlndex - 0; 
unsigned char blnitializationKey[32] - { 
0x6A,0xB5,0xDA,0xED,0xF6,0xFB,0x7MxBE, 

0xDF,0x6F,0x37,0x16,0x00,0x86,0x03,0x61, 

OxBO,0x58,0x2C,0x16,0x8B,0x45,OxA2,OxDl, 

0xE8,0x74,0x3A,0x9D,OxCE,0xE7,0x73,0x39 }; 

// send two zeros to ADDRESS PORT to reset the LFSR 
_outp ( ADDRESS_PORT, 0x00 ); 

_outp ( ADDRESS_P0RT, 0x00 ); 

// send initiation key sequence to put all PnP cards 
// into sleep state. 

for ( wlndex - 0 ; wlndex < 32 ; wlndex++ ) 

_outp ( ADDRESS_P0RT, blnitializationKey[ wlndex ] ); 


a Linear Feedback Shift Register (LFSR). Every PnP card 
compares the initiation key sequence available on the data 
bus with internally generated values byte-by-byte, expecting 
an exact match. The LFSR is initialized by writing a value of 
OOh to the ADDRESS port twice. The initial value of the LFSR is 
6Ah, which is a predetermined standard magic number. This 
number is put through the following process to generate the 
remaining numbers. 

The least two significant bits are XORed and the result is 
used to form the most significant bit of the next byte. The 
remainder of the next byte is formed by shifting the current 
byte right by one position. Applying this algorithm to the ini¬ 
tial value of 6Ah, you have: 

6Ah = 01101010 

X0R the least significant two bits (e.g., 1 and 0) to get a 1-bit 
result 

1 X0R 0 = 1 

Shift the computed bit to the most significant position. 

00000001 « 7 - 10000000 

Form the next value by shifting the current value right by 1 
position. 

01101010 » 1 = 00110101 
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OR the result with the computed most 
significant bit. 

00110101 I 10000000 - 10110101 

This number becomes the next value in 
the sequence. 

10110101 - B5h 

On receiving the initiation key, all 
PnP cards enter the Sleep state in which 
the auto-configuration ports are 
enabled and the configuration process 
begins. Figure 4 shows an excerpt of 
the system configuration code that 
sends the initiation key sequence. For 
efficiency, the code uses a pre-computed 


lookup table rather than computing the 
initiation key on the fly. 

Isolation 

All PnP cards "listen" to the same 
1/O port address, so the system config¬ 
urator needs a mechanism to address 
each card one at a time. Each PnP card 
has a universally unique number called 
the "serial identifier" which forms the 
key element of this mechanism. The ser¬ 
ial identifier is a 72-bit unique, non-zero 
number composed of a 32-bit vendor ID 
field, a 32-bit serial number field, and 
an 8-bit checksum. The fact that the 
vendor ID is assigned by a central gov¬ 
erning body makes the serial identifier 


universally unique across boards from 
different manufacturers. The manufac¬ 
turer, however, must ensure that every 
PnP card has a unique, factory preset, 
32-bit serial number. The serial identifi¬ 
er is accessed bit serially by the isola¬ 
tion logic and is used to differentiate the 
cards. 

The Card Select Number (CSN) is an 
unique handle given to every card par¬ 
ticipating in the PnP isolation process 
after the card has been successfully iso¬ 
lated. In the Sleep state, all PnP cards 
wait for the system configurator to write 
the CSN value to the WAKE register. When 
the system first boots, all cards have 
their CSN set to zero. When the system 
configurator first issues a WAKE command 
with a CSN of 0, every card attempts to 
respond, but only one is successful (this 
process is described in more detail later). 
Cards that have lost out in the isolation 
process are set back to the Sleep state 
and they wait for the next WAKE com¬ 
mand with a CSN of 0. At most, one card 
can be isolated during any WAKE com¬ 
mand. The single card that has been iso¬ 
lated is given a CSN by writing a unique 
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Figure 5 PnP card unique serial number 
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value to the PnP card's CSN register. 
Since it has been assigned a CSN, the 
card no longer responds to any further 
WAKE commands that have a CSN of 0. 
However, the system configurator can 
still communicate with this card by issu¬ 
ing a WAKE command with the CSN that it 
stored in the card's CSN register. 

This isolation process runs as many 
times as there are PnP cards in the sys¬ 
tem. At each iteration, the system con¬ 
figuration issues a WAKE command with 
a CSN of 0, isolates the card that first 
responds, and assigns it a unique, non¬ 
zero CSN that it will use to refer to that 
card in the future. The process is not 
trivial, given that all the cards are sit¬ 
ting on the same ISA bus. The algorithm 
used by a PnP card to respond to a read 
access during isolation is described next 
and summarized by this pseudo-code: 

// 72 bits in all 

for ( n = 0 to 71 bits ) 

{ 

// during the first read access 

if ( Serial ID Byte[n / 8 ]:Bit[n l 8] = 1) 

Write 55h to Data Bus. 

else 

Tristate Data Bus. 
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// during second read access 
if ( Serial ID Byte[n / 8 ]:Bit[ n%8] = 1) 
Write AAh to Data Bus. 

else 

TriState Data Bus. 

if ( (Previous Value on Data bus == 55h) 
&& (Current Value on Data Bus == AAh )) 
Pull out of the isolation process 
for the remaining bits. 

} 

When the system configurator 
issues a WAKE command with a CSN of 
zero, all the PnP cards that have not 
been assigned non-zero CSNs expect 
to see 72 pairs of I/O accesses to the 


READ_DATA port. The card's response to 
these reads depends on the value of 
each corresponding bit of its serial 
identifier. If the current bit of the serial 
identifier is 1, then the card writes a 
55h to the data bus to complete the first 
I/O read cycle. If the bit is 0, then the 
card puts its data bus driver into high 
impedance. Cards with their data bus 
drivers in high impedance check the 
data bus during the I/O read cycle to 
sense if another card is driving a 55h on 
the bus. On the next read cycle, cards 
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that wrote 55h to the data bus previously will now write an 
AAh. If a card that has driven the data bus to the high imped¬ 
ance state senses a value of 55h and then AAh on the data bus, 
it will lose out in the isolation process and will not partici¬ 
pate in the current round of isolation. If a card was either 
writing to the bus, or had put it in a high impedance state 
but did not sense the 55h/AAh pair, then it should prepare for 
the next pair of I/O reads. The card right shifts the serial 
identifier by one bit and uses the shifted out bit to decide the 
next response as shown in Figure 5. 


Figure 6 Waking cards with CSN 


#def 1ne WAKEJSN 0x03 
♦define WRITEJATA 0xA79 

/* . . 

Golntolsolation 

This function fores all cards, except those who have a CSN 
to go into isolation state. 

ENTRY 

bCSN - 0 : Put all cards into isolation state. 

bCSN - XX : Put card whose CSN - XX into config state. 

...*/ 

void Golntolsolation(unsigned char bCSN) 

{ 

_outp ( ADDRESSJORT, WAKEJSN ); 

_outp ( WRITEJATA, bCSN ); 

) 

/*... 

AssignCSN 

This function will assign a CSN to the card that has won 
the isolation process. 

*/ 

♦define CARD_$EL_N0 0x06 

void AssignCSN(void) 

( 

_oirtp ( ADDRESS_P0RT, CARD_$EL_N0); 

_outp ( WRITEJATA, esn); 

1 


Figure 7 Configuring I/O, DMA, and IRQs 


II Configure the I/O ports 

for ( wlndex - 0 ; wlndex < pConfig->wNumI0 ; wlndex++ ) 
t 

_outp ( ADDRESSJORT, ( IOBaseReg + ( wlndex * 2 ) ) ); 
_outp ( WRITEJATA, HIBYTEC pConfig->wI0[ wlndex ] ) ); 
_outp ( ADDRESSJORT, ( IOBaseReg + (wlndex * 2) + 1)); 
_outp ( WRITEJATA, L0BYTE( pConfig->wI0[ wlndex ] ) ); 

1 

// Configure the DMA channels 

for( wlndex - 0; wlndex < pConfig->wNumDMA ; wlndex++ ) 

{ 

_outp ( ADDRESSJORT, ( DMABaseReg + wlndex ) ); 

_outp ( WRITEJATA, pConfig->wDMA[ wlndex ] ); 

1 

// Configure the IRQs 

for( wlndex - 0; wlndex < pConfig->wNumIRQ; wlndex ++ ) 
f 

_outp ( ADDRESSJORT, ( IRQBaseReg + ( wlndex * 2 ) ) ); 
_outp ( WRITEJATA, pConfig->wIRQ[ wlndex ] ); 


The system configurator generates 72 pairs of I/O read 
cycles from the READ_DATA port and checks the data returned 
from each pair of I/O reads. If a 55h/AAh pair is read back, the 
system configurator assumes that some PnP card has a 1 bit in 
that position of the serial identifier. For all other combinations, 
the PnP card is assumed to have a 0 bit in that position. During 
the software read back, it is possible that not even a single 
55h/AAh pair is detected. The system configurator assumes that 
it has set a READ_DATA port that is conflicting with some other 
hardware in the system, which calls for relocating the 
READ_DATA port. The entire range between 0203h to 03FFh is 
available; however, in practice, it is expected that only a few 
locations are tried before the software determines that no PnP 
cards are present. In the sample code, we set the READJATA port 
to 020Bh. To relocate the READ_DATA port, a value of OOh is written 
to the ADDRESS port which selects the card control register 
(CCR). This is followed by writing bits[9:2] of the READ_DATA 
port address to the WRITE_DATA port. This 8-bit value gets writ¬ 
ten to the CCR setting the READ_DATA port. When the READ_DATA 
port is addressed, the value stored in the CCR is sent to 
address lines 9 through 2. The two least significant bits of the 
READ_DATA port address are both set to 1, which allows for port 
addresses only on 4-byte boundaries. As a result, a value of 
0x0082 implies that the READ_DATA port is 0x020B. The card goes 
into a Config state as a result of the CSN being set. Figure 6 
shows code snippets that force all cards to go into isolation and 
assign a CSN to the card that has won the isolation process. 

Reading Resource Data 

Every PnP card stores a readable resource data structure 
that describes the resources it supports. An ISA PnP card can 
have multiple independent devices performing different func¬ 
tions and having independent hardware requirements. In PnP 
nomenclature, each such device is called a logical device. 
Resource information is provided for each logical device. PnP 
resource data is supplied as a series of "tagged" data struc¬ 
tures. A single-byte tag at the beginning of each data structure 
furnishes information about the name, length, and type of the 
resource. To minimize the amount of storage needed for 
resources, PnP cards have two different types of resource data 
structures, called small and large items. Once the PnP card is 
in a Config state, the service configurator reads back the 
resource requirement of the card through the resource regis¬ 
ters. Only a single PnP card can be in the Config state at any 
point in time. Detailed information about the resource data is 
beyond the scope of this article and can be found in the refer¬ 
ences at the end of this article. The system configurator has a 
list of resource requirements for the entire system after repeat¬ 
ing the above process for every PnP card in the system. The 
system configurator is then in a position to perform resource 
balancing. 

Configuration 

This is a process in which the card is configured and 
activated. Each logical device in a PnP card can request a 
maximum of eight I/O ports, two IRQs, two DMA chan¬ 
nels, and four memory locations. All these resources can be 
programmed through a set of standard configuration regis¬ 
ters. The code fragment in Figure 7 shows how the service 
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configurator configures the I/O, 
DMA, and IRQ settings. pConfig 
points to a structure that contains the 
I/O, DMA, and IRQ settings that have 
to be written to the card. IOBaseReg, 
DMABaseReg, and IRQBaseReg are the 
standard ports for writing I/O, DMA 
and IRQ configuration settings respec¬ 
tively, as shown in Figure 8. Figure 8 
gives the details of the configuration 
registers used in the code. 
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Implementation and 
Limitations 

The code disk (see Table of 
Contents for availability) contains a 
real-mode DOS utility for configuring 
PnP devices. The code compiles with 
Visual C++ vl.5 and consists of two 
main sections. First, the main part of 
the code is an ISA PnP protocol han¬ 
dler. Second, some parser routines 
read the settings from the configura- 
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workgroup applications 
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• entry level ANSI SQL '92 
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tion file and pass them to the protocol 
handler. 

The utility has a few limitations. It 
does not read back the configuration 
from the PnP card, so the settings speci¬ 
fied in the file are assumed to be accept¬ 
able to the card. No contention manage¬ 
ment is done. If the settings specified in 
the configuration file conflict with other 
hardware in the system (either PnP or 
legacy), then there is a strong possibility 
that either hardware will refuse to 
work. Even if a system has multiple 
PnP cards, the utility configures only a 
single PnP card during a single run. 

Conclusion 

Though the current implementa¬ 
tions of Plug and Play have their own 
problems related to address decoding, 
etc. — which have emanated due to 
lack of foresight among the protocol 
designers — ISA Plug and Play is still a 
blessing to the PC user community. 
With the advent of Windows 95, most 
hardware vendors are joining the Plug 
and Play bandwagon in order to stay 
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competitive. With every new card sup¬ 
porting Plug and Play standards, set¬ 
ting up a new ISA card will be a much 
more pleasant experience. 
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Figure 8 

Plug and play I/O, IRQ, and DMA configuration registers 








I/O 

Descriptor 

Register 

Index 


Definition 



0 

0x60 

R/W 

The lower limit address bits [15:08] for I/O Descriptor 0. 



0 

0x61 

R/W 

The lower limit address bits [07:00] for I/O Descriptor 0. 



7 

0x6E 

R/W 

The lower limit address bits [15:08] for I/O Descriptor 7. 



7 

0x6F 

R/W 

The lower limit address bits [15:08] for I/O Descriptor 7. 





The I/O Descriptor Register 



IRQ 

Descriptor 

Register 

Index 


Definition 



0 

0x70 

R/W 

Bits [3:0] indicate interrupt level. A value 0 implies no 
interrupt selection. 



0 

0x71 

R/W 

Value indicate type of interrupt. 



1 

0x72 

R/W 

Bits [3:0] indicate interrupt level. A value 0 implies no 
interrupt selection. 



1 

0x72 

R/W 

Value indicate type of interrupt. 





The IRQ Descriptor Register 



DMA 

Descriptor 

Register 

Index 


Definition 



0 

0x74 

R/W 

Bits [2:0] indicate DMA channels. A value 4 implies no 
DMA selection. 



1 

0x75 

R/W 

Bits [2:0] indicate DMA channels. A value 4 implies no 
DMA selection. 





The DMA Descriptor Register 
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Visual Basic 


Using the Task Tray from VB 


Joseph J. Guadagno 


Visual Basic v4.0 


The Windows 95 taskbar has an area that programs can use to show status or pro¬ 
gram-specific information. This area is referred to by a number of names, such as 
"taskbar notification area," but I will call it the task tray. For example, Microsoft Fax 
displays a fax icon in the task tray. When you move the mouse over the icon, a tooltip 
string displaying the current fax status appears. You can left-click on the icon to 
restore the fax status application or right-click on it to get a control menu. This article 
shows you how your Visual Basic 4.0 programs can take advantage of the task tray to 
display their own icons and status information. 

The Task Tray 

Figure 1 shows a screen shot of a task tray that contains two items — an envelope 
and the current time. The envelope is from Microsoft Exchange, which displays an 
envelope to notify the user of new mail. If you move the mouse over the envelope 
and leave it there a few seconds, Windows displays a tooltip-style message with 
helpful information — in this case, it would read "You have new mail". The task tray 
is a handy tool for a programmer to keep the user up-to-date with pertinent infor¬ 
mation and is often the most expedient way to communicate with the user. For 
example, when you print a document, the printer icon appears in the task tray and 
the tooltip shows the printer status. All programs must share a single task tray, so 
you should use it sparingly. 

Shell_NotifyIcon() 

The heart of the task tray interface is Shell_NotifyIcon(), which is included in 
she! 132 .dll. This function has the following prototype: 


Joseph Guadagno has been a computer consultant for five years. He began with MS 
QuickBASIC and moved on to MS Visual Basic. His current duties entail managing a 
five-office WAN network and maintaining a timesheet/payroll system. Joseph can be 
reached at Thejammer@msn.com. 
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can notify the user of a different task that you are performing 
through the task tray. The Microsoft Network is a good exam¬ 
ple. While online, the modem that is placed in the task tray is 
constantly updated with data being sent out, data being sent, 
and total bytes transferred, vbtray.bas (Listing 1) contains 
NewTipt), which lets you modify the tip. You can call it like 
this: 

NewTip Picturel, "My next tip!" 

You pass the picture control and the new tooltip string. You can 
also enhance this function by changing it to allow the caller to 
modify the icon. 

The final step is to remove the icon when you no longer need 
it. The best location to remove the icon is in the Form_Unl oad 
event, vbtray.bas (Listing 1) contains Deletel con (), which you 
can call to remove the icon from the task tray: 

Deletelcon Picturel 

Summary 

Here are some tips for using the Task Tray area in your 
program. 

• Provide a pop-up window that displays additional informa¬ 
tion about the task tray icon when the left mouse button is 
clicked. For example, the audio (speaker) status indicator 
displays a volume control. Use a pop-up window rather 
than a modal dialog box for further information because the 
user can close the window by clicking elsewhere. Position 


the pop-up window near the status indicator so the user can 
move the mouse to it quickly and easily. Avoid displaying 
other types of windows because they require extra user 
interaction to close them. If there is no information that 
applies, do not display anything. 

• Display a pop-up menu for the object represented by the 
icon when the right mouse button is clicked on the icon. On 
this menu, include commands that bring up property sheets 
related to the status indicator. For example, the audio status 
indicator provides commands that display the audio prop¬ 
erties and the Volume Control mixer application. 

• Carry out the default command defined in the pop-up menu 
for the icon when the user double-clicks (i.e., displaying the 
property sheet). 

• Display a tooltip that indicates what the icon represents. For 
example, this could include the name of the indicator, a 
value, or both. 

• Provide the user with an option to not display the icon, 
preferably in the property sheet for the program displaying 
the icon. This allows the user to determine which icons to 
include in this shared space. You may need to provide an 
alternate way to display this status information when the 
user turns off the icon. 

The sample code provided should be enough to get you 
started in using Shel l_NotifyIcon() and help you conquer yet 
another Visual Basic challenge. □ 
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Listing 1 vbtray.bas — Functions to man¬ 
age task tray 


Attribute VB_Name - ”Tray_Functions" 
Public Const NIFJCON - 4H2 
Public Const NIF_MESSAGE - JH1 
Public Const NIF_TIP - &H4 

Public Const NIM_ADD - &H0 
Public Const N1M_DELETE - &H2 
Public Const NIM_MODIFY - &H1 

Public Const WM_M0USEM0VE - &H200 
Public Const WM_LBUTT0ND0WN - SH201 
Public Const WM_LBUTTONUP - &H202 
Public Const WM_LBUTTONDBLCLK - &H203 
Public Const WM_RBUTTONDOWN - &H204 
Public Const WM_RBUTTONUP - 8.H205 
Public Const WM_RBUTTONDBLCLK - &H206 


' Tray Notification Structure 

Type NOTIFYICONDATA 

cbSize As Long 

hwnd As Long 

uID As Long 

uFlags As Long 

uCal 1 backMessage As Long 

hlcon As Long 

szTip As String * 64 

End Type 

Declare Function Shell_Notifylcon Lib ''shell32.dll" Alias _ 

"Shell NotifylconA" (ByVal dwMessage As Long, 

IpData As NOTIFYICONDATA) As Long 

Dim Shared trayStructure As NOTIFYICONDATA 

Public Function Addlconfpic As Control, tip$, f As Form) 

1 This function adds the icon to the system tray 
' The Form is passedfor the icon 
' The pic is the control that recieves the messages 
' The tip$ is the Tool tip the will appear 

trayStructure.szTip - tip$ & Chr$(0) 

’ Flags: the message, icon, and tip are valid and should be 
' paid attention to. 

trayStructure.uFlags - NIF_MESSAGE + NIFJCON + NIFJIP 

trayStructure.uID - 100 

trayStructure.cbSize - Len(trayStructure) 

’ The window handle of our callback control 
trayStructure.hwnd - pic.hwnd 

1 The message CBWnd will receive when there's an icon event 
trayStructure.uCallbackMessage - WMJtOUSEMOVE 
trayStructure.hlcon - f.lcon 
' Add the icon to the taskbar tray 
rc - ShellJlotifyIcon(NlM_ADD, trayStructure) 

End Function 

Public Function Deletelcon(pic As Control) 

' On remove, we only have to give enough information for Windows 

' to locate the icon, then tell the system to delete it. 

trayStructure.uID - 100 

trayStructure.cbSize - Len(trayStructure) 

trayStructure.hwnd - pic.hwnd 

trayStructure.uCallbackMessage - WMJ10USEM0VE 

rc - Shell_Notifylcon(NIM_DELETE, trayStructure) 

End Function 


Public Sub NewTip(pic As Control, tip$) 

' You can change the tip whenever you want during the program 

trayStructure.uFlags - NIFJIP 
trayStructure.uID - 100 
trayStructure.cbSize - Len(trayStructure) 
trayStructure.hwnd - pic.hwnd 
trayStructure.uCallbackMessage - WM_M0USEM0VE 
' New Tip 

trayStructure.szTip - tip$ & Chr$(0) 

rc - Shell_Notifylcon!NIM_MODIFY, trayStructure) 

End Sub 


Figure 2 Sample handler for task tray noti¬ 
fications 


Private Sub picTray_MouseMove(Button As Integer, 

Shift As Integer, X As Single, Y As Single) 

' You should make sure that the picture box 
' is set to Visible - False 

Select Case X 

Case WMJBUTT0ND0WN 

’ Left button is down 
1 blMessage.Caption - "Left Button Down" 

Case WMJBUTT0NUP 

’ Left Button Click 

1 blMessage.Caption - "Left Button Click" 

Case WMJBUTTONDBLCLK 

' Left Button Double Click 
TblMessage.Caption - "Left Button Double Click" 
Case WM_RBUTT0ND0WN 
' Right Button Down 

1 bl Message.Caption - "Right Button Down" 

' This is where you would put support for the menu 
Forml.PopupMenu mnuFile, vbRightMenuAlign 
Case WM.RBUTTONUP 

' Right Button Click 

1blMessage.Caption - "Right Button Click" 

Case WMJBUTTONDBLCLK 

' Right Button Double CLick 
1blMessage.Caption - "Right Button Double Click" 
Case WMJTOUSEMOVE 
' Mouse Move 
Case Else 
End Select 
End Sub 
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Displaying a Window in 
Full-Screen Mode 



1 / Ramachandran 



Borland C++ v5.0 

= 03 = 

Symantec C++ v7.2 

Visual C++ v4.2 


Watcom C++ v10.6 


Visual Age for Windows C++ v3.5 


Even with higher screen resolutions, screen real estate is precious. Menus, tool¬ 
bars, and rulers are handy, but sometimes there's good reason to dedicate the entire 
screen to the content of a single window. Many commercial applications — including 
Microsoft Word and Visual C++ 4.0 — support a full-screen mode, where the entire 
screen is used to display only the application window's client area. The main win¬ 
dow's caption bar, menu bar, window frame, toolbar, and status bar are hidden from 
view so that all available screen space is used to display the application client area. 
Though the menubar is not visible, users can access the menu items via hotkeys. 

I needed this functionality for a product I am currently developing. I thought that 
this would be a simple case of moving and sizing the window so that the entire 
screen is occupied by the client area of the window and the non-client areas are 
clipped off. However, I realized that using only the window position functions (e.g., 
MoveWi ndow( ) and SetWi ndowPos ()) was not enough. This article explains how to 
achieve a full-screen mode identical to that of Word 6.0 by using the Windows SDK 
and presents code snippets you can use to achieve the same functionality. I apply my 
solution to an SDI application, then explain the additions required to make that same 
solution work for MDI applications. 

The Solution 

The basic idea of full-screen mode is that you resize the main window to make the 
client area the same size as the screen (the surrounding window border and caption 
are conceptually located off-screen and are not visible). To allow the user to switch 
back to normal mode, you need to be able to restore the window to its original shape. 

If it were possible to specify the window's position and dimensions while in the 
maximized state, then I could maximize the window in full-screen mode and restore 
it in the normal mode. Windows provides the message WM_GETMINMAXINFO to do just 
that. This message is sent to a window whenever Windows needs either the win¬ 
dow's maximized position and dimensions or its maximum and minimum tracking 
size. If I tell Windows (by responding to WM_GETMI NMAX INFO) that the maximized win¬ 
dow position is to the left and above position (0,0), and that the maximized window 
size is such that the client portion of the window fills the screen, then I can use 
ShowWindow(SW_SHOWMAX I MI Z ED ) to display the window in full-screen mode. 
ShowWi ndow (SW_RESTORE ) would restore the window to normal mode. 

WM_G ETMINM AXINFO 

The 1 Pa ram of this message points to the MI NMAX INFO data structure, which the 
application modifies to specify the maximized window position and dimension: 


V. Ramachandran is a consultant with Imagine Technologies, Madras, India, where he 
develops Document Imaging and Work Flow solutions. He can be reached at 
raja@imagine.globemail.com. 
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} MINMAXINFO; 


typedef struct tagMINMAXINFO { 
POINT ptReserved; 

POINT ptMaxSize; 

POINT ptMaxPosition; 

POINT ptMinTrackSize; 

POINT ptMaxTrackSize; 


I handle this message and, depending on whether or not the 
window is already in full-screen mode, I set all the MINMAXINFO 
members. In full-screen mode, I want to position the window 


Listing 1 fullscr.c — Functions to manage full-screen mode 


^include "fullscr.h" 

// Macros to store the variables as window properties 

#define GET_FULL_SCREEN_STATE(hWnd) \ 

(BOOL)GetProp (hWnd, "FullScreen") 

^define SET_FULL_SCREEN_STATE(hWnd, x) \ 

SetProp (hWnd, "FullScreen”, (HANDLE)x) 

^define GET_MAXIMIZED_STATE(hWnd) \ 

(BOOL)GetProp (hWnd. "Maximized") 
y/define SET_MAXIMIZEO_STATE(hWnd. x) \ 

SetProp (hWnd, "Maximized", (HANDLE)x) 

^define LARGEJUMBER 5000 

static int nyCaption; 
static int nxFrame; 
static int nyFrame; 
static int nxScreen; 
static int nyScreen; 
static int nyMenu; 

/* Init - initialize various window dimensions */ 
static void Init(void) 

{ 

nyCaption - GetSystemMetrics(SM_CYCAPTI0N); 
nxFrame - GetSystemMetrics(SM_CXFRAME); 

nyFrame - GetSystemMetrics(SM_CYFRAME): 

nxScreen - GetSystemMetrics(SM_CXSCREEN); 

nyScreen - GetSystemMetrics(SM_CYSCREEN); 

nyMenu - GetSystemMetrics(SM_CYMENU): 
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) 

int GetFullScreenStatelHWND hWnd) 

{ 

return GET_FULL_SCREEN_STATE(hWnd): 
) 


j ***************************************************************** 

SetFul1 Screen • call this function to set the full screen mode. 
Parameter: Handle of window, flag indicating full screen or not. 

Note: If a window is maximized, calling ShowWindow 
(SW_MAXIMIZE) has no effect. Therefore use SetWindowPos. 

LARGEJUMBER is just an arbitrary large number (5000), so that 
Windows calls WM_GETMINMAXINFO to get the maximized position. 
*****************************************************************/ 

void SetFul1 Screen (HWND hWnd, BOOL bFul1 Screen) 

{ 

int x. y; 

if(!nyCaption) 

InitO; 

x - -1 * nxFrame; 

SET_FULL_SCREEN_STATE (hWnd, bFul1 Screen); 
if (bFul1 Screen) ( 

// Store maximized status 
S ET_MAX IMIZ E D_STAT E (hWnd, IsZoomed (hWnd)); 
if (GET_MAXIMIZED_STATE (hWnd)) { // Use SetWindowPos explicitly 
y - -1 * (nyFrame + nyCaption + nyMenu): 

SetWindowPos (hWnd. NULL. x. y, LARGEJUMBER. 

LARGEJUMBER. SWPJ0Z0RDER); 

} 

else 

ShowWindow (hWnd. SW_SH0WMAXIMIZED); 

1 

else { // Restore to normal position, 

if (GET_MAXIMIZED_STATE (hWnd)) { 
y - -1 * nyFrame; 

SetWindowPos (hWnd. NULL, x. y. LARGEJUMBER. 

LARGEJUMBER. SWPJ0Z0RDER): 

} 

else 

ShowWindow (hWnd. SWJEST0RE); 

} 

} 

/***************************************************************** 
OnGetMinMaxInfo - handler for WM_GETMINMAXINFO 
Called from MainWndProc. 

If full screen is on, set maxsize and max track size to screen 
+ caption + 2 * frame. Else, set it to screen + 2 * frame. 

***************************************************************** j 

void OnGetMinMaxInfo (HWND hWnd, WPARAM wParam, LPARAM IParam) 

{ 

MINMAXINFO FAR * lpMMI - (MINMAXINFO FAR *)1Param; 

if(!nyCaption) 

InitO; 

DefWindowProc (hWnd, WM_GETMINMAXINFO. wParam. IParam); 

if (GET_FULL_SCREEN_STATE (hWnd)) { 

1pMMI->ptMaxPosition.y - -1 * (nyFrame + 
nyCaption + nyMenu); 

lpMMI->ptMaxSize.y - 1pMMI->ptMaxTrackSize.y - nyScreen + 

2 * nyFrame + nyCaption + nyMenu; 

} 

else { 

1pMMI->ptMaxPosition.y - -1 * nyFrame: 

1pMMI->ptMaxSize.y - 1pMMI->ptMaxTrackSize.y - nyScreen + 


1pMMI->ptMaxPosition.x - -1 * nxFrame; 

1pMMI->ptMaxSize.x - lpMMI->ptMaxTrackSize.x 
nxScreen + (2 * nxFrame); 

} 

/* End of File */ 
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so that the menu, caption, and the window border are outside 
the screen. 

I set ptMaxPosi ti on (the position of the upper left corner of 
the maximized window) so that in the y direction, the top bor¬ 
der, the caption, and the menu are outside the screen; while in 
the x direction, the left border is outside the screen: 

1pMMI->ptMaxPosition.y = 

-(nyFrame + nyCaption + nyMenu); 

1 pMMI->ptMaxPosition.x = -nxFrame; 

ptMaxPositi on requires that the point be specified in screen 
coordinates ( 0,0 is the top-left corner of the screen). Since I 
want to position the window above and to the left of (0,0), I 
must specify negative values. nyFrame, nyCapti on, nyMenu, and 
other variables are static variables initialized with values 
updated from GetSystemMetrics(). 

ptMaxSize and ptMaxT rackSi ze are initialized to the size of 
the maximized window. When the window is maximized, I 
want the client area to occupy the complete screen area, which 
means that the non-client areas are outside the screen area. 
The height of the window is therefore equal to the sum of the 
complete screen height, the caption height, the menu bar 
height, and the upper and lower border heights. The width of 
the window is equal to the sum of the complete screen width 
and the left and right border widths: 

1pMMI->ptMaxSize.y = 

1pMMI->ptMaxTrackSize.y = 
nyScreen + 2 * nyFrame + 


nyCaption + nyMenu; 

1pMMI->ptMaxSize.x = 
lpMMI->ptMaxTrackSize.x = 
nxScreen + (2 * nxFrame); 

For the complete code, see OnGetMinMaxInfo( ) in fullscr.c 
(Listing 1). 

Problems with This Implementation 

The above strategy works correctly except in the case 
where the window is already maximized and the user wants 
to go into full-screen mode. Windows does nothing if you call 
ShowWindow(SW_SHOWHAXIMIZED) when the window is already 
maximized. In that case, you must use SetWi ndowPos () instead. 
Use the same formula explained above to calculate the x,y 
position of the window in full-screen mode. You can simply 
specify a very large value (I use 5,000) for the cx and cy para¬ 
meters, since SetWi ndowPos () will cause Windows to send a 
WM_GETMINMAXINFO message and the correct cx and cy values 
will be calculated there. 

Putting It All Together 

I wrote a reusable code module to handle full-screen mode 
in fullscr.c (Listing 1) and fullscr.h (Listing 2). The code 
disk (see Table of Contents for availability) also contains a 
simple application that demonstrates calling these functions. 
Set Ful 1 Screen () is the function to call to set a window in full¬ 
screen mode. SetFul 1 Screen () takes two parameters: the win¬ 
dow handle and a flag indicating whether to set the window 
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to full-screen mode or to restore the normal window mode. 
OnMi nMaxInfol) is the WM_GETMINMAXINFO handler; your window 
procedure should call this function whenever it receives a 
WM_GETMINMAXINFO message. 

Since I need to store the maximized state and the full¬ 
screen state of the window, I use window properties to do it. 
This is a mechanism for storing values so that I don't have to 
resort to global variables — other options include storing the 
information in window extra bytes. 


Listing 2 fullscr.h — Interface to fullscr.c 
functions 


#1f !defined(FULLSCR_H) 

/(define FULLSCR.H 

#if !defined(_INC_WINDOWS) &S !defined(_WIND0WS_H) 

# include <windows.h> 
ifendif 

#1f defined(_cpl uspl us) 

extern "C" ( 
ifendif 

int GetFullScreenStateiHWND hWnd); 

void SetFul1 Screen (HWND hWnd, BOOL bFul1 Screen); 

void OnGetMinMaxInfo (HWNO hWnd. WPARAM wParam, LPARAM lParam); 

#if defined!_cpluspl us) 

}; 

ifendif 
/fend if 

/* End of File */ 


MDI Applications 

The example I've discussed here used a SDI window. For a 
MDI application, you must handle the WM_GETM I NMAX INFO mes¬ 
sage for both the MDI frame window and the MDI child win¬ 
dows. 

By default, the maximum size that Windows allows for 
MDI child windows is equal to the sum of the screen height 
and the upper and lower border heights. My formula for full¬ 
screen mode requires a value equal to the sum of the screen 
height, the upper and lower border heights, and the height of 
the menubar. Therefore, the WM_GETMINMAXINFO handler for the 
MDI child window must be written as follows: 

void OnGetMinMaxInfo (HWND hWnd, WPARAM wParam, LPARAM lParam) 

1 

MINMAXINFO FAR * lpMMI 

= (MINMAXINFO FAR *)1Param; 

DefWindowProc (hWnd, WM.GETMINMAXINFO, wParam, lParam); 
lpMMI->ptMaxSize.y = 

1pMMI->ptMaxTrackSize.y = 

nyScreen + 2 * nyFrame + nyMenu; 

1 

Summary 

If your application displays variable-sized data in its main 
window, then offering a full-screen mode may be worth your 
effort. Full-screen mode is also handy in print preview. For the 
price of a couple of extra function calls, your user can see as 
much data as the entire screen will hold. □ 
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A Technique for Fast MFC 
Compilation 

Daniel Howard 



When you first begin a project with Visual C++, AppWizard generates a header 
file, stdafx.h, that includes the MFC header files you need. However, as you start 
writing code, you will probably call functions that were not defined in this initial set 
of header files, forcing you to identify the needed header file and include it. What 
you really need is a universal header file that includes all the Windows and MFC 
header files. With such a header file, you could concentrate on your code instead of 
fumbling with header files. 

Unfortunately, creating a universal header file is more difficult than it sounds. 
Windows and MFC header files interact with themselves and each other in compli¬ 
cated ways. Many require the programmer to jfdefine values to enable or disable 
options; others need to be included in a certain order. Advanced OLE and the MFC 
source directory implementation header files are so numerous that the MFC devel¬ 
opment team does not have time to test all the interactions between them. For pro¬ 
grammers working at the edge, the Visual C++ Cross Platform Edition for the 
Macintosh presents a whole slew of Macintosh-specific header files. Besides, if you 
ever could create one universal MFC and Windows header file, your programs 
would take forever to compile. This article provides one strategy for achieving a bal¬ 
ance between efficiency and convenience, and provides you with header files that 
will give you everything you need most of the time without including so many 
header files that compiles become intolerably slow. 

A Compromise Strategy 

Most programmers muddle through by fiddling with their stdafx.h until every¬ 
thing compiles. As a result, their header files are inefficient and slow. Even worse, 
they go through the whole process for every new project. It's awful. 

Visual C++ does offer some help. Even though it cannot help you create a more 
sophisticated header file, it speeds up compile times by precompiling. 
Precompiling is a process where Visual C++ reads and parses an header file, stores 
it in a convenient condensed form, then reuses the condensed form for all subse¬ 
quent source files it compiles which include that header file. Since creating and stor¬ 
ing the condensed form takes extra time, this option pays off only if the precom¬ 
piled header file is used in several source files. The AppWizard automatically sets 
up Visual C++ to precompile Stdafx.h, the default file that includes all the basic 
MFC functionality. Precompiled headers really speed up compiling, but the size of 


Daniel Howard is the lead MFC programmer at KnowledgeSet Corporation in Mountain 
View, CA. His interests include graphics, multimedia, and user interface design. 
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the header file can still slow them down. Even if the universal 
header file could be created and precompiled, it would still 
be dreadfully slow. 

To achieve the best compile times and still get all the head¬ 
er files that your source files need for compilation, I use a com¬ 
bination method that blends the best of the universal header 
file and the best of precompiling. I call it the lead-off, clean-up 
header approach. There are two files: one small, blazingly fast 
precompiled header file and another more robust and com¬ 


plete header file. I have carefully tuned these header files for 
maximum effectiveness. 

The lead-off header file is mf chdr 1 . h (Listing 1), and should 
always be included in the stdafx. h file for your project. Since 
it contains only the most commonly referenced MFC struc¬ 
tures and functions and, by default, stdafx. h is the precom¬ 
piled header, most of your source files should compile in a 
fraction of a second. I designed this header file by taking the 
default stdafx. h and tweaking it a bit. 


Listing 1 mfchdrl.h — Precompiled header for all source files to include 


#1 fndef MFCH0R1.H 
♦define MFCHDR1.H 

// Windows 3.x 

#1f defined(_WINDOWS) M !defined(JIIN32) 

// Start: Switches and directives for Windows 3.x 
♦define OEHRESOURCE 

// End: Switches and directives for Windows 3.x 

// Start: Simplified version of mfc\src\stdafx.h 
#include <afxwin.h> 
linclude <afxdlgs.h> 
linclude <afxext.h> 

// End: Simplified version for mfc\src\stdafx.h 

// Start: Directives after including MFC header files 
linclude <fstream.h> 
linclude <ctype.h> 

// End: Directives after including MFC header files 

lei If defined(_WIN32) || defined(_MAC) // NT and Mac 

// Start: Switches and directives for NT and Mac 
♦define OEMRESOURCE 

// End: Switches and directives for NT and Mac 

// Start: Simplified version of mfc\src\$tdafx.h 
♦ifndef ALLJARNINGS 
// disable warning about using init_seg 
♦pragma warning(disable: 4073) 

Ilfdef _MAC 

// disable (incorrect?) warning about packing of 

// MachineLocation in OSUtils.h 

Ipragma warningCdisable: 4121) 

lendif 

lendif 

#1 fdef _AFX_C0RE_IMPL 

♦define AFX_C0RE_DATA AFX_DATA_EXPORT 
♦define AFX_CORE_DATADEF 
lendif 

lifdef _AFX_0LE_IMPL 

♦define AFX_0LE_DATA AFX_DATA_EXPORT 
♦define AFX_01E_DATADEF 
lendif 

lifdef _AFX_DB IMPL 

♦define AFX_DB_0ATA AFX_DATA_EXP0RT 

♦define AFX_DB_DATADEF 
lendif 

lifdef _AFX_NET_IMPL 

♦define AFX.NET DATA AFX.DATA.EXPORT 

♦define AFX.NETJATADEF 
lendif 

♦define VC_EXTRALEAN 
lifdef _MAC 

Idefine SystemSevenOrLater 1 
linclude <macnamel.h> 
linclude <Type$.h> 
linclude <QuickDraw.h> 


linclude <AppleEvents.h> 
linclude <macname2.h> 
lendif 

linclude <afxwin.h> 
linclude <afxdlgs.h> 
linclude <afxext.h> 

// End: Simplified version for mfc\src\stdafx.h 

// Start: Directives after including MFC header files 
typedef RGBTRIPLE FAR* LPRGBTR1PLE; 
linclude <fstream.h> 
linclude <ctype.h> 

// End: Directives after including MFC header files 
lendif // .WIN32 M .MAC 

lendif // MFCHDR1.H 

// End of File 
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♦ FF.................... 

sub2 USERS: main 

CALLS: sub3 sub4 
PARAM: argl arg2 
LOCAL: varl 
GLOBL: var2 var3 


filel main 

file2 

— sub2 

file2 

[—sub3 

file2 

1—sub4 

filel 

— main(recursv) 


— Ibryl, Ibry2 
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The clean-up header file is mfchdr2.h (Listing 2), and it 
takes care of anything not found in mfchdrl. h. If you get com¬ 
piler errors related to MFC structures or functions, you can 
include mf chdr2. h after stdafx.h in the source file. The inspira¬ 
tion for this header is obscure: the mfc\src directory contains 
the stdafx.h normally used for recompiling the whole MFC 
library. For that purpose, the MFC developers included every 
MFC header file in the right order and with all the correct 
switches. By sifting through this file, I extracted all the MFC 
header files. As time passed, I added the relevant Windows 
header files from the Visual C++ include directory and the 
various SDKs I have used over the years. By using these two 
files in tandem, you will get very quick and easy compiles. 

Refining the Process 

Eventually you will probably want to tune mfchdrl.h and 
mfchdr2. h to match your own style and preferences. From my 
experience, the optimal ratio is 1 to 15; in other words, from a 
group of 15 random source files, only one source file should 
need the extra (nonprecompiled) header files included by 
mf chdr2. h. You can observe this ratio by watching Visual C++ 
as it compiles. Visual C++ will whip through source files that 
only include mfchdrl. h in a fraction of a second, but source 
files that include mf chdr2. h will take 3 to 4 seconds to compile. 
If the ratio is too low (e.g., 1 in 10 of your files have to include 
mf chd r 2. h), you should move the most-used header file in 
mf chd r 2. h into mfchdrl. h. If the ratio is too high (e.g., only 1 in 
20 of your source files have to include mfchdr2. h), you should 


MFC 3D Modeling Extensions 
MEX 

MEX Core: 

• Powerful framework (Object/Tool/Editor architecture) for 
modeling application design. 

• Extensive math package: Vector, Matrix, Quaternion, Circle, 
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• 3D Mesh, Light (Omni/Spot) and Camera editor. 
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• Over 180 tools: Array, Bend, Slice... 

• Real time Spotlight and Camera views. 

MEX LF: 

• Lofter model editor. 

• Over 50 tools: 3D Bezier spline lofting path, 2D Bezier spline 
cross-section shapes... 

• Deformation grids: Scale, Twist, Teeter, Bevel and Fit. 
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move the least-used header file in mfchdrl. h over to mf chdr2. h. 
In general, you want to balance the usefulness of the header 
files in mfchdrl.h against the cost of maintaining more pre¬ 
compiled header information. 

Summary 

Although the header files shown here are exclusively 
designed for MFC 2.5 and 4.0, the lead-off, clean-up design 
can be made to work with other libraries and even with other 
programming languages. The two-phased approach is ideal 
for any language that requires prototypes before functions 
and classes can be referenced in the source code. 

Reducing your compile times means that you can spend 
more time on your source code. After all, users evaluate your 
program on what it does in your source code, not on the head¬ 
er files that only get in your way. □ 


Listing 2 mfchdr2.h — Non-precompiled 
header to include as needed 


♦i fndef MFCHDR2J 
define MFCHDR2J 

#1f defined(_WINDOWS) U !def1ned(_WIN32) 

// Start: Switches and directives for Windows 3.x 
♦include <toolhelp.h> 

♦include <..\src\plex.h> 

// End: Switches and directives for Windows 3.x 

// Start: Simplified version of mfc\src\stdafx.h 
#ifdef .WINDOWS 
♦include <afxole.h> 

#1 fdef _AFXCTL 
♦include <ole2ui.h> 

♦el se 

♦include <afxodlgs.h> 

♦include <afxdb.h> 

♦endif 

♦include <afxpriv.h> 

♦include <..\src\auxdata.h> 

♦include <.,\src\auxvars.h> 

♦include <..\src\oleimpl.h> 

♦endif 

// End: Simplified version for mfc\src\stdafx.h 

♦elif defined(_WIN32) || defined(_MAC) 

// Start: Switches and directives for NT and Mac 
♦ifdef _MAC 
♦include <plstring.h> 

♦include <A1iases.h> 

♦endif 

// End: Switches and directives for NT and Mac 

// Start: Simplified version of mfc\src\stdafx.h 
♦1fndef _AFX_N0_0LE_SUPP0RT 
♦1fndef _0LE2_H_ 

♦include <ole2.h> 

♦endif 

♦include <winspool.h> 

♦ifdef _MAC 

♦include <ole2ui.h> 

♦el se 

♦ifndef _0LEDLG_H_ 

♦include <oledlg.h> 

♦endif 

♦endif 

♦include <winreg.h> 
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L i St i n g 2 mfchdr2. h — continued 

//include <. .\src\o1eimpl .h> 

//endif 

//include <afxole.h> 

//ifndef AFX NO SOCKET SUPPORT 


//ifndef WINSOCKAPI 

//ifndef _AFX NO DAO SUPPORT 

//include <winsock.h> 

//include <afxdao.h> 

//endif 

//endif 

//include <sockimpl ,h> 


//include <afxsock.h> 

//include <afxodlgs.h> 

//endif 

//endif 

//ifndef AFX NO AFXCMN SUPPORT 


//include < ..\src\commimpl.h> 

//ifndef AFX NO OCX SUPPORT 

//include <afxcmn.h> 

//include <afxctl .h> 

//include <afxcview.h> 

//endif 

//endif 

//ifndef AFX NO DB SUPPORT 

//ifndef AFX NO RICHEDIT SUPPORT 

//include <afxdb.h> 

//include <afxrich.h> 

//endif 

//endif 

//ifndef AFX NO SYNC SUPPORT 


//include <afxmt.h> 

//include <winreg.h> 

//endif 

//include <winnls.h> 


//include <stddef.h> 

//include <afxpriv.h> 

//include <1 imits.h> 

//include <..\src\afximpl .h> 

//include <mal 1 oc.h> 

//include <..\src\winhand .h> 

//include <new.h> 

//ifndef AFX NO OLE SUPPORT 

// End: Simplified version for mfc\src\stdafx.h 

//include <..\src\oleimpl2.h> 


//endif 

// Start: Directives after including MFC header files 

//ifndef AFX NO OCX SUPPORT 

// Include your own Win32 files here 

//include fctlimpl ,h> 

// End: Directives after including MFC header files 

//endif 


//ifndef AFX NO DB SUPPORT 

//endif // WIN32 M MAC 

//include <..\src\dbimpl.h> 


//endi f 

//endif // MFCHDR2 H 

//ifndef AFX NO DAO SUPPORT 


//include <daoimpl.h> 

// End of File 
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Compiler Benchmark: Matrix 
Multiplication 




Ron Burk 



Borland C++ v5.0 

eE3= 

. Symantec C++ V7.2 

i Visual C++v4.1 


Watcom C++ v10.6 


Visual Age for Windows C++ v3.5 


This month's benchmark uses the second section of Arch D. Robison's OOPACK 
suite to measure how well Win32 compilers generate code. This interesting set of 
benchmarks checks to see how much faster the code generated for an algorithm writ¬ 
ten in C is than the equivalent algorithm implemented in an object-oriented style 
with C++. Ideally, the ratio is 1.0, which means that the compiler's optimizer is good 
enough that you pay no penalty for writing object-oriented code in C++ rather than 
procedural code in C. 

As with last month's benchmark, I compared 32-bit Windows compilers from five 
different companies. The compilers and versions used were: Visual C++ v4.1, 
Borland C++ v5.0, Watcom C++ vl0.6, Symantec C++ v7.2, and Visual Age for 
Windows C++ v3.5 (IBM). The compilation options used are shown in Table 1. You 
can get the original benchmark from Arch D. Robison's Web page at 
http: / /www. kai. com/oopack/oopack. html, or get the slightly altered benchmark used 
here from our Web page at www. wd j. com. 

Floating-Point Overhead 

Any time I take the trouble to perform a benchmark, I almost always learn some¬ 
thing new. As I was running this month's benchmark, I noticed something odd: the 
floating-point version of the benchmark ran faster than the integer version. In other 
words, I was benchmarking the same algorithm once with a matrix of i nts and again 
with a matrix of doubl es, and getting faster times for the doubl es. This conflicted with 
my sense of reality, since I know that floating-point manipulations (multiply, divide, 
add, etc.) on the PC are from 50 to 500 percent slower than integer manipulations. I 
started disassembling the code to see if the compiler had managed some clever loop 
optimization for the floating-point code that it had failed to produce for the integer 
code. It hadn't. Then I noticed that it wasn't just one compiler — all the compilers 


Ron Burk is the editor of Windows Developer's Journal. You can reach him at 
70302.2566@compuserve.com or http://ourworld.compuserve.com/homepages/RonBurk. 
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except one produced faster execution times for the floating¬ 
point version of the algorithm. I began to think I was missing 
something big. 

In fact, I was missing something big, and had been for 
some time. The last time I did serious floating-point work on 
the PC, I was using an 8087 coprocessor. The Intel floating¬ 
point hardware has since gotten faster — a lot faster. The prob¬ 
lem is that my experience-based "feel" for the efficiency of 
floating-point work on the PC had been outpaced by the 
relentless Intel hardware advances. This retaught me the 
importance of always measuring before talking about efficien¬ 
cy. In this case, I was completely surprised to learn from my 
measurements that a floating-point multiply on my 133MHz 
Pentium can actually be faster than a integer multiply. I later 
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found a quote in Michael Abrash's Zen of Code Optimization 
that indicates this was true as far back as the 80486, so I've 
been missing the boat for some time now. The hardware and 
software environment for Windows programmers changes 
fast enough that it is almost always dangerous to rely just on 
your past experience when you're talking about efficiency. 
You simply must measure to be sure! 

This Month's Benchmark 

This month, I ran integer and floating-point versions of the 
second part of the OOPACK benchmarks. This benchmark 
measures and compares the speed of two implementations of 
a simple matrix multiplication. The C-style algorithm the 
benchmark uses looks like this: 

// Dimension of (square) matrices, 
const int L = 50; 

// The matrices to be multiplied. 

DATA C[L*L], D[L*L], E[L*L]; 

void MatrixBenchmark::c_style() const { 
fort int i=0; i<L; i++ ) 

fort int j=0; j<L; j++ ) { 

DATA sum = 0; 
fort int k=0; k<L; k++ ) 
sum += C[L*i+k]*D[L*k+j]; 

E[L*i+j] = sum; 

1 

1 

This is then compared with a more object-oriented implemen¬ 
tation: 

// a matrix stored in row-major format 

class Matrix { 

private: 

DATA *data; // Pointer to matrix data 
public: 

int rows, cols; // # of rows and columns 

Matrixtint rows_, int cols_, DATA * data_) 

: rowstrowsj, colstcolsj, data(data_) 

(1 
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// Access element at row i, column j 
DATA& operator()( int i, int j ) { 
return data[cols*i+j]; 

} 


// Compute E=C*D with OOP style 

void MatrixBenchmark::oop_style() const { 

Matrix c( L, L, C );// Set up three matrices 
Matrix d{ L, L, D ); 

Matrix e( L, L, E ); 

// Do matrix-multiplication 
fort int i=0; i<e.rows; i++ ) 

fort int j=0; j<e.cols; j++ ) { 

DATA sum = 0; 

fort int k=0; k<e.col s; k++ ) 
sum += cti, k)*d(k,j); 
eti, j) = sum; 

} 

} 


The main point is that the code will be quite slow if the 
compiler actually performs a multiply and addition to 
obtain the address of each matrix element in the innermost 
loop. Ideally, a compiler would generate nearly the same 
fast code for both of these implementations of the algo¬ 
rithm. 

Benchmark Results 

Figure 1 shows the result of running the benchmark with 
DATA typedef'ed to i nt, while Figure 2 shows the results with 
DATA typedef'ed to double. There are a number of interesting 


points in these two figures. Borland holds the ironic distinc¬ 
tion of being both the fastest and the slowest at the floating¬ 
point version of the benchmark. This could only come about 
because Borland ships two 32-bit compilers: bcc32.exe and 
bcc32 i .exe, the latter being ostensibly better at producing 
optimal code. In last month's benchmarks, bcc32i .exe did 
not handle simple C++ inlining very efficiently, but in this 


Ratio of C++ to C 

1.2 0.9 1.0 1.0 1.3 1.3 



Borland Borland Microsoft Watcom Visual Age Symantec 
(bcc32) (bcc32i) for Windows 
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Figure 2 Floating-point benchmark results 
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with Marquis VB/FailSafe T 
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Above and Beyond Visual 
Basic’s Debugger! 

VB/FailSafe Highlights Bugs! Watch OLE 
servers & program flow. Spot event 
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Monitor memory & resource usage. Catch 
parameter errors, symbol table exhaustion, 
control problems, OCX/VBX/DLL version 
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VB/FailSafe Crash-Proofs your Programs 

by automatically intercepting and coding 
errors by class, project, module, procedure 
and line number. Writes log files for later 
debugging and QA. Shows calls leading to 
the error, over 75 data points to help you 
spot platform problems fast! 

VB/FailSafe Analyzes & Profiles 

procedures with microsecond resolution. 
Profile resources, memory, hits, time, 
utilization. Graphically displays information. 
Highlights performance bottlenecks! Spots 
memory hogs! Much more! 

Money Back Guarantee! • Free Demo 
P.O. Box 387, Pomfret Center, CT 06259 
(860) 963-7065 fax (860) 928-7727 


“Marquis has assembled some dynamite tools 
and utilities. They go above and beyond 
Visual Basic’s debugging capabilities... 

for smooth operation. ” 
—VB Tech Journal, Feb. ’96 
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But we're changing all that. Our 75 conference classes will teach you to 
slim down graphics, speed up your site, link up to your corporate data¬ 
base, increase security, manage cybercash and a hell of a lot more. 
We don't print a catalog, so to learn more and register, do what any self- 
respecting web developer would do—visit our web site. 


Web Design & Development ^*6 East 
October 28-November 1,1996, Washington, D.C. 

In conjunction with Software Development '96 East 


Feeling nostalgic? Contact us by phone at 617.821.9215 or by e-mail at web96@mfi.com 








benchmark it produced excellent results for both C and C++ 
(where inlining was again required). 

bcc32i. exe seemed to produce a ratio of 0.9 for its winning 
floating-point code. That implies that it actually generated 
faster code for the more complex C++ style algorithm than for 
the simpler C-style implementation of the same algorithm. 
However, as with previous benchmarks, this appeared to be 
round-off error in the timings, as disassembly showed that the 


Figure 3 

bc32iexe 

The winning optimized code from 

; -- Begin @MatrixBenchmark@oop_sty1e$xqv 



; mark begin; 




ALIGN 

4 

0 


PUBLIC 

@MatrixBenchma rk@oop_style$xqv 



@MatrixBenchmark@oop_style$xqv PROC NEAR 



@B6@2: ; 

preds: B6.1 



push 

esi 

314 


push 

ebp 

314 


push 

ebx 

314 


xor 

ebp, ebp 

318 


xor 

esi, esi 

318 



; LOE:%ebp%esi%edi%esp 



@B6@3: ; 

preds; B6.7 B6.2 



xor 

ebx, ebx 

319 



; LOE;%ebx%ebp%esi%edi%esp%bl%bh 



@B6@4: ; 

preds: B6.6 B6.3 



fid 

QWORD PTR @2@6_2i12f1oatpacket@2 

320 

mov 

edx, ebx 

321 


lea 

eax, DWORD PTR [0+ebp*8] 

321 


lea 

ecx, DWORD PTR 400[0+ebp*8] 


321 

;LOE:%eax%edx%ecx%ebx%ebp%esi%edi%esp%al%ah%d1%dh%cl%ch%b1%bh%f3 

@B6@5: ; 

preds; B6.5 B6.4 



imp 

@L4 

0 


@L5: 


0 


faddp 

st(l), st 

0 


@L4: 


0 


fid 

QWORD PTR C[eax] 

322 


fmul 

QWORD PTR D[0+edx*8] 

322 


add 

eax, 8 

321 


add 

edx, 50 

321 


cmp 

ecx, eax 

321 


jg 

@L5 

321 


faddp 

St(1), St 

322 


;L0E;%eax%edx%ecx%ebx%ebp%esi%edi%esp%a1%a h%dl%dh%cl%ch%bl%bh%f3 

@B6@6; ; 

preds; B6.5 



fstp 

QWORD PTR _E[esi+ebx*8] 

323 


inc 

ebx 

319 


cmp 

ebx, 50 

319 


ji 

@B6@4 ; PROB 70% ; 319 



; LOE:%ebx%ebp%esi%edi%esp%bl%bh 



@B6@7: ; 

preds; B6.6 



add 

esi, 400 

318 


add 

ebp, 50 

318 


cmp 

esi, 20000 

318 


ji 

@B6@3 ; PROB 95% ; 318 



; LOE:%ebp%esi%edi%esp 



@B6@8: ; 

preds; B6.7 



pop 

ebx 

325 


pop 

ebp 

325 


POP 

esi 

325 


ret 


325 


ALIGN 

4 

0 


; LOE:%ebx%ebp%esi%edi%esp%bl%bh 



; mark end; 




@MatrixBenchmark@oop_styl e$xqv ENDP 



; End of File 





compiler produced identical code for both algorithms. 

Figure 3 shows the code produced by bcc32i.exe for the 
floating-point version of the benchmark. It's really quite good, 
and I'm impressed that the compiler produced identical code 
for both implementations of the algorithm. The other compil¬ 
ers (except for bcc32.exe) tended to generate code similar to 
that in Figure 3. All the compilers except bcc32.exe were in 
roughly the same ballpark. For example, some of the differ¬ 
ences in speed appeared to be merely the difference of one or 
two instructions of generated code. 

Microsoft scored well on this benchmark, as they did on 
last month's benchmark. They beat everyone on the integer 
version of the benchmark and came in second on the floating¬ 
point version of the benchmark. 

Summary 

Once again, the good news is that more than one compiler 
was able to deliver quality code with no speed penalty for 
writing object-oriented (rather than procedural) code. It's also 
good news to me that common floating-point operations have 
an order of magnitude less overhead than the last time I 
looked. The bad news is that you still have to measure in order 
to know what your particular compiler will do for your pro¬ 
gram. bcc32 i. exe did poorly at optimizing C++-style code last 
month, but was the winner this month — an example of why 
you should beware of generalizing about these compilers. 
Next month. I'll look at the final benchmark from Arch 
Robison's OOPACK suite. □ 




SDK Annotation #134 


TYPE: MFC 4.0 

TOPIC: CEdit::PosFromChar 

KEYWORD: CEdit::PosFromChar 

The MFC wrapper internally calls the 
EM_POSFROMCHAR function passing the 
documented values. Unfortunately, there is a 
documentation error in EM_POSFROMCHAR, 
and therefore PosFromChar will not work 
correctly. 

Read SDK Annotation #132 or PSS Q137805 
for more details. This error has been corrected 
in MFC 4.1 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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We thought about 
getting President 
Clinton to speak at 
our D.C. conference. 


But we figured 
you’d rather hear 
Tim Berners-Lee. 



Register for Software Development ’96 East 
October 28-November t, Washington. D.C. 

As the inventor of the World Wide Web, Tim 
is considerably more qualified to provide you with 
insights into web development. As are the 30 
other web authorities teaching at SD ’96 East. 

With 200 classes and 175 tools vendors, SD '96 
East is the largest development event on the East 
Coast. You’ll learn concrete skills from expert 
instructors including Bruce Eckel, Mark Pesce 


and Richard Hale Shaw.Trade intelligence with the indus¬ 
try’s smartest development professionals. And preview 
the latest tools for intranet development, object-oriented 
programming, client/server migration and rapid 
application development. 

To get your SD ’96 East conference catalog, 
call us at 800.441.8826 or 415.905.2702. Or send 
us e-mail at sd96east@mfi.com. 

We’ll provide you with an exceptional oppor¬ 
tunity' to meet face-to-face with some of the most 
influential leaders in Washington, D.C. 
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Can't find that Tech Tip from a past 
issue? The Windows Developer's 
Journal CD-ROM with full search 
capabilities is now available. See pages 
24 and 36 for more information. 

I've been a practicing Windoivs developer for about six years now — about the age of this 
magazine (not coincidentally). When I say "practicing," however, I mean it in the alternate 
sense: "I've been practicing medicine for ten years now; sooner or later I'm bound to get it 
right ..." Occasionally, my ignorance of what must seem the most trivial issues to actual 
Windows developers is made painfully obvious. 

To make the most of it, I can at least parade my own learning experiences through this col¬ 
umn so that any readers in a similar, primitive state of Visual Ignorance might see some ben¬ 
efit. In that spirit, the following Tip is in the form of the actual dialog between myself and Tip 
contributor Sud Menon as he suffers some heroic hand-holding for the benefit of your humble 
editor. 

il Dragging Captionless Dialog Boxes 


Sud Menon 
Pittsburgh, PA 
sudhir@mastech.com 


From: Sud 
To: Leor 

I am working on an application in which I represent objects as windows (some¬ 
thing like a flow charting application). These windows do not have caption bars. 
However, I needed a very easy and inexpensive way to drag them around on the 
canvas. Using MFC, I found that a very easy way to do this was to override 
OnNcHitTest (), call the base class function, and then return HTCAPTION (even though 
my window does not have a caption). This fools Windows into thinking that the 
mouse is on the caption bar and it allows me to drag the window as if it were on the 
caption bar. This approach can be used to simulate behavior for other return codes 
for NcHitTestO, too. 

//Code to implement drag in two lines. 

U1NT CMyWnd::OnNcHitTesttCPoint point) 

{ 

CWnd::OnNcHitTest(point); 
return HTCAPTION; 

1 

From: Leor 
To: Sud 
Hi, 

You sent a nice little tip on getting a handle on a title-bar-less tip a while back. I 
was trying to implement this in a VC++ test program, and can't figure out how to 


Leor Zolman is a consultant specializing in C/C++ programming training, an instructor 
on UNIX topics for Boston University's Center for Information Technology, and "Tech 
Tips" editor for Windows Developer's Journal. His book, Illustrated C, was pub¬ 
lished in 1992. He may be contacted at 74 Marblehead St., North Reading, MA 01864. 
Internet address: leor@bdsoft.com. 



Edited by Leor Zolman 


Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they should! 
You'll receive at least $50 for each tip 
that we print. 

Send your submissions: 

- via the Internet to: 
leor@bdsoft.com 

- from CompuServe to: 
>INTERNET:leor@bdsoft.com 

- or by regular mail to: 

Leor Zolman 

74 Marblehead Street 
North Reading, MA 01864 
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Not compiler-specific; 
suitable for any programming platform 


■ Learn today’s premiere programming 
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■ New! Integrated Labs to master concepts 
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■ Progress step-by-step through the key 
language features 
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S3 Move from C to C++ in just 2 days 
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with C++ 


HHNNHRHRRHHM 


Taught by 

Windows 95/Windows NT Programming 
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programming with VC++/MFC 4.0 

New! Integrated Labs (bring your own 
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■ Explore the MFC architecture 

■ Use VC++/MFC 4.0 for Rapid Application 
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and modify new C++ classes 

■ Learn MFC’s document-view architecture 
Build dialog-only applications 


Form views, toolbars with cool user- 
interface components 

■ Use VC++ 4.0’s built-in Component 
Gallery objects 
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Use OLE controls in your VC++ 
applications 

Create MFC extension DLLs 
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Discover the wonder of OLE Automation 
Build Automation servers 
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Produced by the Software Development Conference & Show Group of Miller Freeman, Inc. 

600 Harrison Street, San Francisco, CA 94107 
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attach a message map for OnNCHi tTest(); it only seems to be 
defined for some comboboxes. How would I use this to create, 
say, an About box with no title bar that I can drag around? 

—leor 

From: Sud 
To: Leor 
Hi there, 

What you need to do is to 

a) Add the line 

afxjnsg UINT OnNcHitTestl CPoint point ); 

in the message handlers section of your 
dialog header file. 

b) Add the line 

0N_WM_NCHITTEST() 

to the message map section of your 
dialog.cpp file. 

c) In OnNcHi tTest ( ), have the line return 
HTCAPTION as the last line. 

This will do the trick for you. I am 
assuming that you have already 
removed the caption for the About box 
through a resource editor. 

[I can proudly attest to the fact I had 
indeed removed the caption on my very 
own! — leor] 

Hope this helps. 

From: Leor 
To: Sud 
Hi there, 

OK, thanks, I got it working. I didn't 
know exactly what to do in NcHitTestt), 
so I passed the ball back to CDialog's 
version and just added the return state¬ 
ment. The final result is: 

afxjnsg UINT 

CAboutDTg::OnNcHitTest(CPoint point) 

1 

CDialog::OnNcHitTestlpoint); 
return HTCAPTION; 

1 

Does this make sense to you? It does 
work, so if anything. I'm doing more 
than I need, but I don't know. 

Is there any way to induce VC++ to 
add OnNcHi tT est () for me through 
Class Wizard, or must I manually make 
the three changes you outlined in the 
CPP file? 

From: Sud 
To: Leor 

It does make sense in that it achieves 
the window drag and drop in a single 
line of code. However, one needs to 


bear in mind that Windows relies on the result of the 
WH_NCHITTEST message to post certain messages, and by 
returning HTCAPTION you achieve your purpose, but it also 
causes certain problems. For example, client area messages 
like WM_LBUTT0ND0WN, WM_LBUTTONUP, WM_M0USEMOVE, and WM_PAINT 
are no longer sent. In their place, you get their NC equivalents 
(WM_NC PA I NT, WH_NC LBUTTON DOWN, etc.) These serve the purpose 
well. The user must, however, remember to use them and also 
to track these messages down during debugging (with Spy 
etc.). 

As far as ClassWizard is concerned, use the Cl ass Info tab, 
and then change the Message Filter to Window. This should 
allow you to have a WM_NCH 1 TTEST handler. 
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System Commander 
makes it safe and easy 
to add as many OSes to 
your PC as you want! 

System Commander 
helps protect your 
existing OS from new 
OSes. Installing a new 
OS leaves existing 
OSes unusable. And 
Windows 95 even goes 
a step further. 

Easy Installation 
System Commander's 
automatic installation 
will have your PC ready 
to add new operating 
systems in minutes. 

After installing System Commander, 
your first reboot brings up a menu of the 
OSes already installed. Select the OS 
you want and System Commander does 
the rest. Want to use another OS? Just 
reboot and make another selection. 

Saves You Time and Effort. As you 
install new OSes, System Commander 
automatically adds the OS to its menu. It 
manages unique copies of autoexec.bat 
and config.sys for each copy of DOS, OS/2 
or Win 95 and updates future changes. 

"Highly recommended" 

John C. Dvorak - PC Magazine 


"... Version 2.0 is sensational" 
Nicholas Petreley - InfoWorld 

“System Commander is a blooming miracle" 
Jerry Pournelle - BYTE 


Saves You $$$ 

Instead of investing 
thousands of dollars 
in new PCs, System 
Commander makes it 
safe and easy for you 
to have as many as 
100 different OSes on 
a single PC. 

Boot from any 
combination of hard 
drives, any size and 
type of drive. Put up 
to 32 operating 
systems in a single 
DOS partition and/or 
put each OS in its own 
primary or logical 
partition. System Commander can 
handle any Intel compatible OS, in 
English or any other language, and any 
combination of operating systems! 

Now you can experience exciting new 
OSes like Windows 95 without the risk! 

System Commander is only $99.95 and 
comes with an unconditional . 60 day 
money back guarantee. Get Free 
overnight shipping when you mention 
this ad.* Order it now and have it on your 
desk tomorrow morning! 

800 - 648-8266 

-,-y V Communications, Inc. 

■ 4320 Stevens Creek Blvd, #120-WD 

San Jose, CA 95129; fax 408-296-4441 

408-296-4224 

www.v-com.com 


•When ordered before noon PST. No Saturday delivery. Standard shipping outside US. CA res. add $7.25 sales tax. Offer subject to 
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change without notice. All logos and product names are trademark 
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Smart WM_MOUSEMOVE 


Muthuvale Shanmugam 
Overland Park, KS 
103624.1501@compuserve.com 

Two mouse-related messages I miss very much in Windows 
are WM_MOUSEMOVEIN and WM.MOUSEMOVEOUT. When the mouse cur¬ 
sor enters a window, I would like WM_MOUSEMOVEIN and when the 
cursor leaves the window, I would like WM_M0U$EM0VE0UT. Let me 
first explain why I need those new mouse messages, then I will 
go about ways to generate them. Following are two situations I 
know of where these messages are needed. 

Toolbar Help Text 

Many of today's standard applications have a toolbar with 
a series of buttons. Whenever the user places the mouse cur¬ 
sor on any of the toolbar buttons, the application will pop up a 
rectangle with appropriate help text in it. When the user 
moves the cursor out of the toolbar, the application will 
remove the rectangle. But there is a catch in implementing 
this: if the user moves the mouse cursor from the toolbar to 
another application in a snap, the toolbar or its application 
will never get any messages. Instead, the other application 
will get those messages, so the toolbar will not know that it 



can remove the rectangle. It will assume that the mouse cursor 
is on the toolbar, while it is actually over some other applica¬ 
tion's window. Had Windows generated a WM_M0USEM0VE0UT 
message, this would not have happened. 

I played around with a couple of applications to check this 
out and observed very different behaviors. MS Word 7.0 
removed the rectangle properly when I gradually moved the 
mouse out, but when I moved the mouse out in a snap, it let 
the rectangle stick on. PowerBuilder could remove the rectan¬ 
gle properly, but when I moved the mouse from a toolbar but¬ 
ton directly to the border, it did not let me size the border. 
Netscape 2.0 could remove the rectangle in all cases without 
any side effects. 

Slide Hide Window 

Slide Hide Window may not be a standard term; Slide Hide 
Window is basically a Popup Window. What is special about 


continued on page 50 


Listing 1 mousemsg.c 

#1nclude "windows.h" 

#include "windowsx.h" 


fdeflne WM MOUSEMOVEIN 

WM USER+1 

ifdefine WM.MOUSEMOVEOUT 

WMJSER+2 



For C and C++ Developers .... 


When the RichEditControl is not Enough. 


Are you writing a 

• Document Viewer? 

• Multimedia Product? 

• Report Generator? 

• Forms Package? 

• HTML Editor? 

• Email Application? 

• Electronic Book Technology? 

• Hypertext Enabled Program? 

• Program with text features? 

Then you need PAIGE. 

PAIGE™ is a library of run-time 
functions you can embed into your 
application. It will add virtually unlimited, 
programmable “rich edit” word processor 
and page layout features to any part of your 
program. 

PAIGE will save you hundreds of precious development 
hours. Better yet with PAIGE’s cross-platform API you can 
support the most popular desktop operating systems. 


IGE is the solution when 
r “edit” controls fail. 


Key PAIGE Features 


Cross-platform API 
• Embed anything into text 
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• Wrap text in/around graphics 
• Overlay text on graphics 
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• Full MFC support 
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Listing 1 mousemsg.c — continued 


BOOL CALLBACK DialogProcCHWND, UINT, WPARAM, LPARAH); 
void MyDispatchMessageCMSG FAR *); 

HWND hwnd - NULL; 

static bMouseln - FALSE; 

BOOL InitlnstanceCHINSTANCE hlnstance. int nCmdShow) 

{ 

hwnd - CreateDialog(hInstance, "MainDialog", 

NULL, DialogProc); 
if (!hwnd) 

return (FALSE); 

ShowWindowthwnd, nCmdShow); 

UpdateWindow(hwnd); 
return TRUE; 


#ifdef _BORLANDC_ 

#pragma argsused 
#endif 

int PASCAL WinMain(HINSTANCE hlnstance, 

HINSTANCE hPrevInstance, LPSTR IpCmdLine, int nCmdShow) 

{ 

MSG msg; 

POINT pt; 

if (ilnitlnstancethlnstance, nCmdShow)) 

{ 

MessageBoxCNULL, "InitApp Failed", NULL, MB_0K); 
return (FALSE); 

) 

GetCursorPos(&pt); 

bMouseln - WindowFromPoint(pt) — hwnd; 

whi1e(GetMessage(&msg, 0, 0, 0)) 

{ 

TranslateMessage(Smsg); 

DispatchMessageUmsg); 

MyDispatchMessage(Smsg); 

) 

return (msg.wParam); 


#ifdef _BORLANDC_ 

//pragma argsused 
#end1f 

static BOOL DialogCommand(HWND Dialog, int Control Id, 

HWND Control, UINT Notify) 

{ 

If(Control Id — I00K || Control Id -- IDCANCEL) 

{ 

DestroyWindow(Oialog); 

PostQuitMessage(O); 

) 

return FALSE; 

} 

BOOL CALLBACK DiaTogProc(HWND Dialog, UINT message, 

WPARAM wParam, LPARAM IParam) 

( 

switch (message) 

{ 

case WM_M0USEM0VEIN ; 

SetDlgItemText(Dialog, 101, "Mouse Entered”); 
break; 

case WM_M0USEM0VE0UT : 

SetDlgItemText(Dialog, 101, "Mouse Left"); 
break; 

HANDLE_MSG(Dialog, WM_C0MMAN0, DialogCommand); 

) 

return FALSE; 


void MyDispatchMessage(MSG FAR* pmsg) 

{ 

//If mouse is in then check if it has gone out. If 
//mouse is not in then check if it has come in. 
if(bMouseln) 

{ 
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//As long as there is no message for this application 
//track the mouse cursor position. 
while(!PeekMessage(pmsg, 0, 0, 0, PM_NOREMOVE)) 

( 

POINT pt; 

HWND hwndBuf; 

GetCursorPosUpt); 

hwndBuf - WindowFromPoint(pt); 

//If window at mouse cursor position is not this 
//app's window and not any of its child windows 
//then it means mouse has left the app area, 
iff hwndBuf !- hwnd && !IsChi1d(hwnd, hwndBuf)) 

{ 

bMouseln - FALSE; 

PostMessagethwnd, WM_MOUSEMOVEOUT, 0, 0L); 



) 

else 

{ 

//If the mouse is not in and the app has received 
//mouse move message the it means mouse has entered, 
if(pmsg->message — WM_M0USEM0VE || 
pmsg->message — WM_NCM0USEM0VE) 

{ 

bMouseln - TRUE; 

PostMessagethwnd, WM_M0USEM0VEIN, 0, 0L); 

} 

) 

) 

/* End of File */ 
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continued from page 46 

this Slide Hide Window is that it normally will not show itself 
fully — it will be just peeping in from one of the screen's sides. 
All the user will be able to see is its border. I call this Slide 
Hide mode. When the user moves the mouse over the win¬ 
dow's border, the Slide Hide Window will slide in and show 
itself completely. I call this Slide Show mode. Moving the cur¬ 
sor out of the window will make it slide back to its Slide Hide 
mode. Slide Hide Windows will typically be always on top, 
but will save screen real estate by being in Slide Hide mode. 
To implement this type of window, I needed messages 
WM_M0USEM0VE IN and WH_M0USEMOVEOUT. 

Generating WM_MOUSEMOV EIN is easy — you can have a flag to 
indicate if the mouse is in or out of your application area. If 
the flag says that the mouse is out, and if you get WM_M0USE- 
MOVE, post yourself a WH_M0USEM0VEIN message. 

But generating WM_M0US EMOV EOUT is not that easy because 
you don't get the message — some other application's win¬ 
dow does. Following are four methods of generating 
WM_M0USEM0VE0UT, the fourth of which I have implemented. 

Capture the mouse as soon as it enters your application by 
calling SetCapturet ) and track it until it leaves by processing 
the WM_M0USEM0VE message. When the mouse leaves your win¬ 
dow, release the capture and post WM_M0US EMOV EOUT message. 
This will work, but as long as your application has captured 
the mouse, you will not receive any non-client mouse mes¬ 
sages. The non-client mouse messages will now come in as 
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class editor, code 
coverage and metrics 
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regular mouse messages. This will affect your window's 
default behaviors like sizing the window, moving the win¬ 
dow, etc. with the help of the mouse. 

You can use MouseHookProcf ) and trap every WM_M0USEMOVE 
message, and when the cursor is out of your application area, 
post yourself a WM_M0US EMOV EOUT message. The hook has to be a 
system-wide hook. Due to performance and compatibility 
with future Windows versions, this is not recommended. 

Install a timer event request and let Windows post a 
WM_TIMER message periodically. During every timer message, 
check the mouse cursor position using GetCursorPos (), and 
when it is out of your application area, post a WM_M0US EMOV EOUT 
message. Timer messages will incur a slight overhead, but if 
your system is already receiving timer messages frequently, 
this may be an acceptable choice. 

My preference is to peek into the message queue. You need 
to keep track of the mouse from the moment it enters into 
your area until it leaves. Since WinMain()'s message loop has to 
be modified, a new function MyDi spatchMessagel ) should be 
called from the message loop. In MyDi spatchMessagef ), as long 
as there is no message in the message queue, use 
GetCursorPos! ) to find the cursor position. When the cursor 
position is out of your area, post yourself a WM_M0USEM0VE0UT 
message and return from MyDi spatchMessage!). 

mousemsg. c (Listing 1), mousemsg. rc (Listing 2), and 
mousemsg.def (Listing 3) show an implementation of this 
approach. 

Based on the individual circumstances, any of the four 
approaches cited above can be used. For my requirements, 
peeking into the message queue created the least amount of 
side effects. One problem with this approach is that 
MyDi spatchMessaget ) gets called for every message; it appears 
that this may slow down the system. Based on the require¬ 
ments, this system can be fine tuned by calling 
MyDi spatchMessage( ) only during certain situations. O 


Listing 2 mousemsg.rc 


#1 Delude <windows.h> 

MainDialog DIALOG 0, 0, 188, 60 

STYLE DS_M0DALFRAME | DS_3DL00K | DS.CONTEXTHELP | 

WS_P0PUP I WSJISIBLE I WS_CAPTION | WS_SYSMENU 
CAPTION "Mouse Test" 

FONT 8, "MS Sans Serif" 

1 

CONTROL "OK", IDOK, "BUTTON", BS_PUSHBUTTON | BS_CENTER 
| WS_CHILD | WSJ/ISIBLE | WS_TABST0P, 68, 40, 50, 14 
CONTROL "", 101, "static", SS.LEFT | WS_CHILD | 
WS.VISIBLE, 20, 12, 152, 12 

1 


Listing 3 mousemsg.def 

NAME 

mousemsg 

DESCRIPTION 

’Default module definition file for mousemsg.exe.’ 

EXETYPE 

WINDOWS 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

4096 

STACKSIZE 

16384 
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Can't find that hug from a past issue? The Windows 
Developer's Journal CD-ROM with full search capabilities is 
now available. See pages 24 and 36 for more information. 

Bug++ of the Month 

Mark Nelson 


If you discover a bug in the latest version of your favorite compiler, 
email it to us at wdletter@mfi.com. Please specify which version of 
your compiler you are using and include a tiny program that 
demonstrates the problem, along with the exact command-line 
options needed to compile it. 

Traditionally, a newly elected President in the USA is grant¬ 
ed an informal grace period upon taking office. Referred to as 
a "honeymoon" by the press, the first few months of the term 
are generally free of political hardball, both from Congress 
and the press. Of course, like all honeymoons, duration and 
quality will vary widely. 

Likewise, programmers tend to give compiler vendors some 
slack when it comes to compliance with language standards. 
Nobody expects Microsoft or Borland to produce a compiler 
that matches the ANSI C++ standard the day it's ratified. 

By now, however, the ANSI committee's draft standard is 
past its first birthday. Both Microsoft and Borland have issued 
major and minor updates during that year, so it would seem 
reasonable to expect that they should be pretty well in synch 
with the standard. "Bug++ of the Month" fan Philip Staite was 
happy to point out just how unreasonable an idea this actual¬ 
ly is. But first, Philip had to give me a small training course in 
C++ constructor rules. 

Given a class definition for type T that has an i nt construc¬ 
tor, many of us have probably written code such as this: 

irt foot) 

{ 

T bar = 3; 


If you do this using Borland's or Microsoft's compilers, you 
will see that the compiler happily generates a call to the con¬ 
structor for T that takes a single integer argument, with the 
result being object ba r. As far as I was concerned, that was the 
end of the story. But Philip took me all the way back to section 
12.6.1 of the Annotated Reference Manual for an explanation of 
explicit initialization. As it turns out, the above code should 
actually generate a call to the integer constructor, creating a 
temporary object T (3) that would then be copied into object 
ba r using the copy constructor. 

The ARM specifically says that implementers are free to 
generate a call to the integer constructor directly for object bar, 
and skip the call to the copy constructor. In fact, the ARM says 
"a good compiler notices that there is no need to introduce the 
temporary and eliminates it." But — and this is important — 
the program still has to obey access control for the copy con¬ 
structor, even if it isn't called. This is a fairly important facet of 
the language and has survived from the ARM into the ANSI 
draft. There isn't any reason to suppose it won't still be there 
when the final copy of the standard finally pops out of the 
ANSI/ISO laser printers. 

The Bug 

Philip noticed that when he created a class that had a pri¬ 
vate (and hence inaccesible) copy constructor, both the 16- and 
32-bit versions of Microsoft Visual C++ blithely ignored that 
fact, taking the shortcut around it with no regard for access 
control. My version of his test program is shown in Listing 1 
(bug0996.cpp). 


Mark Nelson is a programmer for Greenleaf Software in Dallas, Texas. Mark is the author of The C++ Programmer's Guide to the 
Standard Template Library, from IDG Books, as well as The Data Compression Book, from M&T Books. You can reach Mark on the 
Web at http://web2.airmail.net/markn. 
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The program should have failed to compile, pointing out 
the problem with access to the copy constructor in the first 
statement in ma i n (). Instead, it compiled and ran under Visual 
C++, producing the following output: 

T::T(int) 

T::~T() 

The compiler optimized around the need for the copy con¬ 
structor, ignoring the access problems presented by it. 
Microsoft's John Browne cheerfully acknowledged the bug 
and promised a fix: 

This indeed a bug, and has been slated for a fix in a future 
release. 

C++ is a complex language, so perfect coverage and com¬ 
pliance would be a daunting task. I expect compiler certifica¬ 
tion will be a healthy niche industry for some time to come. 
But it is disconcerting to see bugs like this which are rooted in 
the early 1980s core of the language. Access rules such as the 
one discussed here go all the way back to "C with classes," the 
proto-C++ that got the ball rolling. 

You can certainly see where Microsoft's priorities will 
probably lie. Let's face it — efficient development environ¬ 
ments, class wizards, documentation, and application frame¬ 
works are what sell the compiler. Language legalities are 
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minor annoyances that only provoke the Redmondian behe¬ 
moth into flicking its tail from time to time. 

But someone has to try to keep Microsoft honest, and this 
month Philip Staite was nice enough to volunteer. He'll 
receive a free WDJ t-shirt, which he will proudly wear in the 
Rochester, Minnesota offices of his employer, another well- 
known behemoth. Please send your bugs in to 
wdl etter@mfi. com, and we'll see if we can't provoke a swat or 
two in your name. □ 

Symantec Slays Bug 
in Record Time 

I ran across an interesting code generation bug in 
Symantec's 16-bit 7.2 compiler while working on the Julian 
date functions in Greenleaf ArchiveLib. The program 
below shows the distilled version of the bug, which pro¬ 
duced the following output: 

11 = 5800, should be 5800 

12 = 10700, should be 5900 


I dutifully uploaded the code below to Symantec's 
CompuServe forum and put it aside for the day. 

I was pleasantly surprised when I received a mail mes¬ 
sage about six hours later from Walter Bright, the custodi¬ 
an of this compiler dating back through several companies 
and many years. Walter's approach was a little different 
than what I usually see from Microsoft or Borland: Walter 
actually sent me an update of the compiler with the bug fix 
in place! 

Regular visitors to the Symantec forum know that 
Walter frequently jumps in to help out with sticky prob¬ 
lems such as this. Symantec may or may not be your com¬ 
piler of choice, but you have to appreciate this kind of ser¬ 
vice. Walter clearly takes pride in his compiler and stands 
behind it. That's nice to see in this day and age! □ 

// BUGSYM.CPP 

II 

// This program demonstrates a code generation 
// bug in Symantec’s 7.2 16 bit compiler. Just 
// compile this using a no frills command line: 

II 

II sc test.cpp 
II 

II The output of the program shows that the 
// calculation of 12 is done as: 1 + 4800 + 4900 
// instead of 1 + 4900. 

// 

(/include <1 ostream.h> 

void foo( int i ) 

1 

long 11 - i + 48001; 
long 12 - 1 + 4900L; 

cout « "11 - " << 11 « ", should be 5800\n”; 
cout « ”12 - " « 12 « ", should be 5900\n"; 

1 

mainO 

1 

foot 1000 ); 
return 1; 

1 

//EOF 
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Listing 1 bug0996.cpp — Demonstrating a 
bug in Visual C++ 4.1 and 1.5 


II This listing demonstrates a bug in Visual 
// C++ 4.1 and 1.5. The creation of object foo in 
// mainO is done with an integer initializer. 

// In theory, this will require the creation 
// of a temporary using the int constructor of 
// type T, followed by an invocation of the 
// copy constructor to create foo. 

II 

// Most compilers shortcut this process by 
// directly invoking T(int) instead. This 
// is a legal shortcut, but it still has to 
// obey the access rules for the copy ctor. 

II 

// This is discussed in some detail in 12.6.1 
// of the ARM. 

II 

#i nclude<iostream.h> 

class T { 
private : 

T( const T& ); 
public: 

TO { cout « "T::TO" « endl; } 

T( int x ) { cout << "T::T(1ntj" « endl; } 
-TO { cout « "T::~TO" « endl; } 

}; 

int mainO { 

T foo = 2; //Requires T(int) and T( T& ) 
return 0; 

} 

//EOF 
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TOPIC: CEdit::CharFromPos 
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The MFC wrapper internally calls the 
EM_CHARFROMPOS function passing the 
documented values. Unfortunately, there is a 
documentation error in EM_CHARFROMPOS, 
and therefore CharFromPos will not work 
correctly. 

Read SDK Annotation #133 or PSS Q137805 
for more details. This error has been corrected in 
MFC 4.1 

Get the entire set of annotations from www. wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications” 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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NTThread Scheduling 

Paula Tomlinson 


Key Points 

❖ No matter how much of its time slice is left, if a higher 
priority thread becomes ready to run while your 
thread is executing, you will be preempted. Period. 
This is true for both Windows NT and Windows 95. 

❖ A thread of equal priority that becomes ready will 
always preempt your thread under NT, but will not 
preempt your thread under Win95. This behavior 
could change in future versions of these operating sys¬ 
tems. 

❖ The priority you give a thread is just a number that is 
used in calculating its actual priority. The actual pri¬ 
ority can vary dynamically at runtime, as it is adjust¬ 
ed up or down by the operating system under vari¬ 
ous conditions. 

❖ The operating system tinkers with actual thread prior¬ 
ities at runtime in the hopes of avoiding problems like 
thread starvation and deadlock. 

❖ The precise algorithm by which the operating system 
tinkers with thread priorities is not documented, is dif¬ 
ferent between Win95 and NT, and may vary from one 
release to the next. 

❖ You cannot discover the actual dynamic thread priori¬ 
ty by calling GetThreadPriorityi ), nor can you alter 
the current dynamic thread priority by calling 
SetThreadPri ori ty (). 

❖ Never rely on thread priority to guarantee order of 
execution or prevent deadlocks or race conditions. The 
only robust solution to these problems is to use explic¬ 
it synchronization. □ 


eH3= 

Borland C++ v5.0 

Symantec C++ Ml.2 

Visual C++ v4.1 


Watcom C++ vl 0.6 


Visual Age for Windows C++ v3.5 


My April 1996 column on multithreaded programming 
prompted a couple of thought-provoking letters from readers. 
Although many books and articles have explained the basic 
Win32 priority scheme for processes and threads. I've yet to see 
a comprehensive study of the exact nature of thread scheduling 
on either Windows NT or Windows 95. Even Matt Pietrek's 
probing book, Windows 95 System Programming Secrets, defers a 
detailed discussion of Windows 95 thread scheduling to anoth¬ 
er book he might write in the future. In this column. I'll look at 
a few of these thread scheduling issues. 

Immediate Thread Preemption 

In your Windows Developer's Journal article (April 1996), 
you wrote: 

The thread can be preempted (...) because a higher priority thread has 
become available (in which case the thread is immediatly preempted, 
even before it finishes its time slice). 

Are you absolutely sure about that? I’m not. My understanding 
would rather be: when any thread is running (whatever its priority 
level) and as soon as it had the chance to be scheduled, the thread can 
run until the end of its time slice without being preempted by any 
other thread. (Of course, it might not go to the end of its time slice if 
it calls GetMessagef ) or UaitForSingleEventO, etc.). 

If I'm wrong, then the situation you describe (on a mono proces¬ 
sor machine) would occur only if the current thread does anything 
(e.g., SetEventO) that would allow another thread with a higher 
priority to run. 

What do you think? 

Philippe Goutier 


Paula Tomlinson has been developing DOS, Windows and Windows-NT based applications and device drivers for eight years. The opin¬ 
ions expressed here are hers alone. She can be contacted via the internet at paulat@microsoft.com. 
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Phillipe asks a very good question here. In the April col¬ 
umn, I provided no proof of my assertion that higher priority 
threads can immediately preempt lower priority threads. 
Fortunately, it's fairly easy to construct a simple program to 
prove that my original statement was correct. The proof will 
also, interestingly enough, demonstrate a crucial difference in 
how threads are scheduled on Windows 95 and Windows NT. 

Higher Priority Always Preempts 

To demonstrate my point, I wrote a simple console program 
that has a single source file — threadl. C (Listing 1). I need to 
construct a situation in which a higher priority thread becomes 
available while a lower priority thread is executing with most 
of its time slice left. First, I create an event for use later in the 
thread routines. Then I create two threads in the suspended 
state (the thread procedures won't run until they're resumed). I 
save the thread handles in an array so that the main thread can 
wait on both thread handles to exit before the main thread exits. 
For clarity, I defined the values HIGH and LOW to correspond to 
indexes in the thread handle array. The hThread[HIGH] thread 
handle corresponds to the ThreadProc_Hi gh () thread procedure 
and the hThread [ LOW] thread handle corresponds to the 
ThreadProc_Low( ) thread procedure. At this point, of course, the 
threads have the same base priority (the priority of the process) 
and the same relative priority (THREAD_PRI0RITY_N0RMAL). I 
then explicitly set the relative thread priority of 
ThreadProcJighO to TH READ_PRI ORI TY_H I GH EST and 
ThreadProc_Low( ) to THREAD_PRIORITY_LOWEST. This causes 
ThreadProc_High () to have an overall thread priority value that 
is 4 higher than ThreadProc_Low( ). main() then resumes 
ThreadProc_High( ) first, then ThreadProc_Low( ), and waits until 
both threads have terminated. 

Since ThreadProc_H i gh () has higher priority, it gets to run 
first. ThreadProC_H i gh () immediately waits on an event that 
has not been signaled yet. This allows ThreadProc_Low( ) to 
begin executing. The first task ThreadProc_Low( ) performs is to 
set the event that ThreadProC_Hi gh () is waiting on. Since 
SetEventO is fairly efficient, ThreadProc_Low( ) will not have 
exhausted its time slice yet. If my original statement is correct, 
then Th read P roc_H i gh () is now ready to run and should 
immediately preempt ThreadProc_Low( ) even though it has 
not finished its time slice yet. In this case, the next line of code 
to be executed should be the second line in ThreadProc_Hi gh ( ), 
which sets the global gChar variable to H (for high priority). 
Then Th read P r oc_H i gh( ) would exit and ThreadProc_Low() 
would finally get to set the global gChar variable to L (for low 
priority). Back in mai n( ), when the value of gChar is printed to 
the screen, it should be set to L because the last thread to set 
the global variable was ThreadProc_Low( ). 

On the other hand, if I'm wrong and ThreadProc_Low( ) is 
allowed to continue executing until its time slice is exhausted, 
then the last thread to modify the global gChar variable will be 
ThreadProc_High( ). In this case, ma i n () should print an H to the 
screen. This was the simplest, yet safest proof I could think of. I 
also added calls to OlitputDebugStri ng( ), which you can view if 
you run the program via a debugger. Running threadl.exe on 
Windows NT always results in the following screen output: 

Last thread to finish was L 


I believe I've now established that when a higher priority 
thread becomes runnable, it can immediately preempt a lower 
priority thread even before the lower priority thread has 
exhausted its time slice. If you run this program on Windows 
95, you will see the same results; assoonasThreadProc_High() 
is ready to run, it immediately preempts ThreadProc_Low(). 

Preemption Can Happen at Any Time 

In this example program, the reason that the higher priori¬ 
ty thread became ready to run (thus immediately preempting 
the current thread) was that the current thread called 
SetEventO. However, don't be lulled into thinking that only 


Listing 1 threadl.c — Preemption by a 
higher priority thread 


// cl /W3 /DSTRICT threadl.c 
// bcc32 -w -DSTRICT threadl.c 
//include <windows.h> 

//include <stdio.h> 

//define HIGH 0 
//define LOW 1 

DWORD WINAPI ThreadProcJigh(PVOID); 

DWORD WINAPI ThreadProc_Low(PVOID): 

HANDLE hEvent - NULL; 

CHAR gChar - 0x0; 

VOID main!) 

{ 

HANDLE hThread[2]; 

DWORD ThreadID; 

hEvent - CreateEventINULL, FALSE, FALSE, NULL); 

hThreadfHIGH] - CreateThreadfNULL, 0, ThreadProc_High, 
NULL, CREATE_SUSPENDED, SThreadlD); 

hThread[LOW] - CreateThreadCO, 0, ThreadProc_Low, 

NULL, CREATE_SUSPENDED, SThreadlD); 

SetThreadPriority(hThread[HIGH], 

THREAD_PRIORITY_HIGHEST); 

SetThreadPriority(hThread[LOW], 

THREAD_PRIORITY_LOWEST); 

ResumeThread(hThread[HIGH]); 

ResumeThreadC hThreadC LOW]); 

WaitForMultipie0bjects(2, hThread, TRUE, INFINITE); 
printfCLast thread to finish was }c\n", gChar); 
return; 

) 

//ifdef_BORLANDC_ 

//pragma argsused 
//endif 

DWORD WINAPI ThreadProc_High(PVOID Param) 

{ 

WaitForSingleObject/hEvent, INFINITE); 
gChar - 'H'; 

OutputDebugStri ng("ThreadProc_High"): 
return TRUE; 

} 

//ifdef_BORLANDC_ 

//pragma argsused 
//endif 

DWORD WINAPI ThreadProc_Low(PVOID Param) 

{ 

SetEvent(hEvent); 
gChar - 'L’; 

OutputDebugString("ThreadProc_Low”); 
return TRUE; 

} 

/* End of File */ 
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calls to certain functions like SetEventO could cause your 
thread to be preempted in the middle of its time slice. A high¬ 
er priority thread could become ready to run for a variety of 
reasons. For example, if the higher priority thread was waiting 
for an asynchronous I/O to complete, then that I/O could 
complete anytime during the execution of your thread and 
cause it to be immediately preempted. In fact, even a lower 
priority thread whose I/O completes could preempt you 
because of dynamic priority boosting (discussed later). 

Under 16-bit Windows, programmers (sometimes uncon¬ 
sciously) came to rely on the fact that their code could only 
lose control of the CPU at key points, such as during a call to 
GetMessageO or PeekMessage(). When writing multithreaded 


code under NT, you must eliminate any such notion. Unless 
you explicitly manage the threads in your program with syn¬ 
chronization objects (e.g., events, semaphores, etc.), then you 
must assume that your thread could be preempted by another 
thread at any time. You can't ever assume, for example, that 
because your thread just started it will get to execute at least a 
few instructions before anything else preempts it. 

Equal Priority Always Preempts (Under NT) 

Now consider the case where the two threads have equal 
priority. I'll call these thread routines TheadProc_A( ) and 
ThreadProc_B( ); the code is in thread2.c (Listing 2). Once 
again, I create each thread in the suspended state and resume 
first ThreadProc_A () and then 
ThreadProc_B(). ThreadProc_A( ) imme¬ 
diately waits for the event which gives 
ThreadProc_B( ) a chance to execute. 
Even though ThreadProc_B( ) immedi¬ 
ately sets the event that ThreadProc_A () 
is waiting on, since both threads are 
running at the same priority, shouldn't 
ThreadProc_A( ) be allowed to finish its 
time slice? The answer is that it 
depends on whether you're running 
Windows NT or Windows 95. In my 
testing on Windows 95, ThreadProc_B( ) 
consistently continued to execute even 
after releasing the event and 
ThreadProc_A( ) only ran again after 
ThreadProc_B( ) terminated (in this case, 
ThreadProc_B( ) is able to execute and 
terminate before its first time slice is 
exhausted). As a result, running 
thread2.exe on Windows 95 results in 
the following screen output: 

Last thread to finish was A 

On the other hand, when I run 
thread2.exe on Windows NT, 
ThreadProc_A( ) consistently preempts 
ThreadProc_B( ) in the middle of its time 
slice. Why would a thread be allowed to 
preempt another thread of equal priori¬ 
ty? The answer is that the actual 
dynamic priorities of the threads are 
not equal at that moment. When 
ThreadProc_B( ) calls SetEventO, NT 
gives the waiting ThreadProC_A( ) a tem¬ 
porary priority boost. The amount of 
boost a thread is given depends on the 
type of event that has completed (such 
as an I/O request completing or an 
event handle being signaled). 

To my knowledge, the exact nature 
and degree of these dynamic thread 
priority boosts is not documented 
explicitly by Microsoft. Although 
Windows 95 also implements some 
form of dynamic thread priority 
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-lint 


for C/C++ 
Version 7.0 

presents Bug # 578 


1 

#include <iostream.h> 



2 




3 

class X 



4 

t 



5 

public: 



6 

X( const & X ) 

{ kind = "copy". 

} 

7 

X( ) { kind = 

"original"; } 


8 

char *kind; 



9 

>; 



10 




11 

void f( X x ) 



12 

{ cout << x.kind; 

> 


13 



| 

14 

int main() 



15 

t 



16 

X x; 



17 

f( x ); 


• 

18 

return 0; 



19 

> 


— 


It was the programmer’s intent that whenever the class X is ' copied ' through the copy 
constructor the value of' kind ' was to reflect that fact. But instead of printing "copy" it 
prints "original". Where did the programmer go wrong? Call if you need a hint, or refer 
to our web page at http: / /www. gimpel. com. 
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parameters, unparenthesized bodies and 
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The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
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boosting, it is obvious from this example that the mecha¬ 
nisms are not identical between the two operating systems. 
This example also demonstrates how important it is not to have 
any assumptions in your code about the exact order in which 
threads get executed. 


Dynamic Thread Priority Adjustment 

I found your article about multithreaded programming (WDJ, 
April 1996) very informative. I don't know if you're planning to 
address this subject again in future articles, but if you do, there is 
another multithreading topic you may want to explain. Consider this 


Listing 2 thread2.c — Preemption by an equal priority thread 

^include <windows.h> 

WaitForMultipTe0bjects(2, hThread, TRUE, INFINITE); 

^include <stdio.h> 

prlntf("Last thread to finish was %c\n", gChar); 


return; ► 

#define A 0 

} 

#define B 1 



#i fdef BORLANDC 

DWORD WINAPI ThreadProc A(PVOID); 

#pragma argsused 

DWORD WINAPI ThreadProc B(PVOID); 

f/endif 


DWORD WINAPI ThreadProc AfPVOID Param) 

HANDLE hEvent = NULL; 

{ 

CHAR gChar - 0x0; 

WaitForSingleObject(hEvent, INFINITE); 


gChar - 'A'; 

VOID mainO 

OutputDebugStringf"ThreadProc A"); 

f 

return TRUE; 

HANDLE hThread[2]; 

i 

DWORD ThreadID; 



#ifdef BORLANDC 

hEvent - CreateEventtNULL, FALSE, FALSE, NULL); 

jfpragma argsused 


#endif 

hThread[A] - CreateThread(NULL, 0, ThreadProc A, 

DWORD WINAPI ThreadProc BtPVOID Param) 

NULL, CREATE SUSPENDED, SJhreadID); 

{ 


SetEvent(hEvent); 

hThread[B] = CreateThread(NULL, 0, ThreadProc B, 

gChar • ' B ' ; 

NULL, CREATE_SUSPENDED, AThreadlD); 

OutputDebugStringC'ThreadProc B"); 


return TRUE; 

ResumeThread(hThread[A]); 

} 

ResumeThread(hThread[B]); 

/* End of File */ 
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situation: a system is runn'ng three threads — A, B and C. A is a 
high priority thread that is waiting for a resource held by thread B 
(using hlaitForSingleObjectf ),for example). Thread B, however, is 
a low priority thread and as result does not get any CPU time because 
of thread C, a medium priority thread. The result: the high-priority 


thread A is effectively blocked by the lower priority thread C. As I 
understand it, in order to avoid this situation, Windows NT and 
Windows 95 implement automatic thread priority boost strategies. 
Windows NT periodically boosts a thread's priority so that it gets to 
use the CPU from time to time. Windows 95 implements an appar- 


Listing 3 thread3.c — Proof of dynamic priority boosting 

//include <windows.h> 

for (i-0; i < OxFFFFFFF; i-H); 

//include <stdio.h> 

OutputDebugString("Ending main thread work\n" ) ; 

DWORD WINAPI ThreadProc High(PVOID); 

return; 

DWORD WINAPI ThreadProc_Low(PVOID); 

) 

HANDLE hEvent - NOLL; 

//ifdef_BORLANDC_ 

//pragma argsused 

VOID main!) 

ifendif 

f 

DWORD WINAPI ThreadProc HightPVOID Param) 

HANDLE hThreadHigh, hThreadLow; 

{ 

DWORD ThreadID, i; 

OutputDebugStringl"Entering ThreadProc_High\n”); 

WaitForSingleObjectIhEvent, INFINITE); 

hEvent - CreateEventtNULL, FALSE, FALSE, NULL); 

OutputDebugString(”Exiting ThreadProc_High\n"); 
return TRUE; 

hThreadHigh - CreateThreadtNULL, 0, ThreadProc_High, 

NULL, CREATE_SUSPENDED, SThreadID); 

) 

#i fdef_BORLANDC_ 

hThreadLow - CreateThreadtNULL, 0, ThreadProc Low, 

#pragma argsused 

NULL, CREATE.SUSPENDED, &ThreadID); 

lendif 

DWORD WINAPI ThreadProc Low(PVOID Param) 

SetThreadPrioritylhThreadHigh,THREAD PRIORITY HIGHEST); 

{ 

SetThreadPriority(hThreadLow,THREAD_PRI0RITY_L0WEST ) ; 

OutputDebugStringC'Entering ThreadProc_Low\n”); 

SetEvent ( hEvent ) ; 

ResumeThreadlhThreadHigh); 

OutputDebugString(”Exiting ThreadProc_Low\n"); 

ResumeThread(hThreadLow); 

return TRUE; 

OutputDebugStringC'Starting main thread work\n"); 

/* End of File */ 
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ently more sophisticated strategy. Recognizing that thread A depends 
on thread B, the Windows 95 kernel will boost thread B's priority to 
that ofA’s until it releases the resource thread A is waiting for. 

I often use threads for performing periodic asynchronous tasks. 
Now for the problem: the threads I use are often very simple and task 
specific. I would like them to do what they need to do and get out of 
the way as quickly as possible. This indicates that they should have a 
high priority. But if I give them a high priority won't that cause my 
other threads to be boosted as well? This not what I want. Obviously 
I can raise and lower the threads priority on each iteration of the 
loop, but that seems inefficient. 

Dan Shappir 

Dan's hypothetical multithreaded example illustrates a 
second type of dynamic thread priority adjustment. I'm refer¬ 
ring to the dynamic priority adjustment that both Windows 
NT and Windows 95 give to threads that haven't had a chance 
to execute recently. 

Starving Threads Get Boosted 

To verify that both Windows 95 and Windows NT do, in 
fact, provide this dynamic priority boosting, I wrote 
thread3. c (Listing 3). th read3 . c is based on the multithread¬ 
ed scenario that Dan described above. The main thread will 
be my compute-intensive, medium (normal) priority thread. 
The main thread simply executes a lengthy for loop, so it 
does nothing that would cause the thread to be explicitly 
preempted. As in Dan's example, ma i n () creates a high pri¬ 


ority thread that waits on an event held by a low priority 
thread. If the operating system did not provide any dynam¬ 
ic thread priority adjustments, the high priority thread 
would not have a chance to run until the medium priority 
thread finished executing the for loop — this would cause 
my other two threads to be effectively deadlocked for the 
duration of that operation. 

In Figure 1, I've sketched the basic sequence of thread 
execution that actually occurs for thread3.exe on both 
Windows NT and Windows 95. Even though each operating 
system employs a different algorithm for dynamic thread 
boosting, in this case the only difference that would be obvi¬ 
ous at the application level is the very first sequence. Under 
Windows NT, maind gets to begin executing its for loop 
before ThreadProc_Hi gh () preempts it. On Windows 95, 
ThreadProc_Hi g h () is called before main() begins executing 
the for loop. For both operating systems, once 
ThreadProc_Hi g h () has entered a waiting state, maind exe¬ 
cutes the for loop for at least one time slice before 
ThreadProc_Low( ) is boosted high enough to run. The exact 
number of time slices required for ThreadProc_Lowest( ) to 
transition from TH RE AD_P R I0RITY_L0WEST to at least 
THREAD_PRIORITY_NORMAL is difficult to measure and can 
change from one test run to the next. The important point to 
note is simply that both Windows NT and Windows 95 do, 
in fact, boost the dynamic priority of ThreadProc_Low( ). This 
feature of the operating system can prevent low priority 
threads from being completely starved by higher priority 
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compute-intensive threads. It also helps prevent some types 
of deadlock scenarios in carelessly written programs. 

A side note of this question is whether or not Windows 
95 actually uses knowledge of the fact that one thread is 
holding a resource that another thread is waiting on to 
determine how to boost that thread's priority. After trying 
several different experiments, I could not confirm that 
Windows 95 does anything other than just gradually boost 
threads that aren't getting a chance to run. On the other 
hand, if a waiting thread has just become ready to run, the 
amount of boost (if any) it receives can vary depending on 
what it was waiting on (an event, the completion of an I/O 
operation, a message, etc). 

You Can't Override Dynamic Boosts 

What if your design called for a high priority thread to 
run to completion at high priority and then get out of the 
way as quickly as possible? Could you simply make fre¬ 
quent calls in the high priority thread to 
SetThreadPriorityt. . ., THREAD_PRIORITY_HIGHEST ) and 
frequent calls in the other threads to 
SetThreadPriorityt. . ., THREAD_PRIORITY_LOWEST)? That 

attempt to override the dynamic priority boosts would not be 
effective. The dynamic priority of a thread is not directly visi¬ 
ble to your program. If you call GetThreadPriority! ), you will 
always get the base thread priority value that the thread was 
set to. This value does not include any dynamic adjustments 
that may be in effect at the time. Likewise, calling 
SetThreadPriorityt) does not override any dynamic boosts 
that may be in effect at the time. If you really want the high pri¬ 
ority thread to complete quickly and then get out of the way, 
you will need to implement some type of synchronization 


between your threads, whereby the lower priority threads 
would wait for the completion of the higher priority thread. 

Conclusion 

Windows NT and Windows 95 both offer priority-based 
multithreaded scheduling. On both operating systems, when 
a higher priority thread becomes ready to run, it will immedi¬ 
ately preempt any lower priority thread (even if the lower pri¬ 
ority thread has not completed its time slice). Both operating 
systems also offer similar (but not identical) forms of dynamic 
thread priority boosting. The exact nature of the dynamic pri¬ 
ority boosting varies between the operating systems, however, 
so it is of utmost importance to test multithreaded programs 
on both Windows NT and Windows 95. Also, it is very dan¬ 
gerous to make assumptions about what order threads will be 
scheduled in and when they will be preempted. Using the pri¬ 
ority of a thread to control execution order and avoid dead¬ 
locks or race conditions is very dangerous. Code that makes 
these kinds of assumptions might run with 100 percent relia¬ 
bility on one operating system but fail every time on the other 
operating system. Thread priorities are a powerful program¬ 
ming tool, but they should be used for their intended purpose 
only: to allow threads to have more or less overall CPU usage 
compared to other running threads. 

References 

Custer, Helen. Inside Windows NT. Redmond: Microsoft Press, 
1993. 

Pietrek, Matt. Windows 95 System Programming Secrets. San 
Mateo: IDG Books, 1995. 

Tomlinson, Paula. "Understanding NT," Windows Developer's 
Journal, April 1996. □ 


Figure 1 

Execution flow of thread3.c 
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Borland's Official No-Nonsense 
Guide to Delphi 2 

Michelle M. Manning 
350 pages 

Sams Publishing, 1996 
$25.00 

ISBN 0-672-30871-1 


[Editor's note: this review was provided by George Tylutki.] The 
book is aimed at the "beginning or casual Windows program¬ 
mers" — those who need to learn how to size a pane and place 
components on a form. There are short descriptions, usually 
accompanied by pictures, of every menu item, speed button, 
and option choice. Deleting an item is explained numerous 
times (click on the item and press the delete key). 

There are 47 chapters with an average of seven pages. Each 
concludes with an "Essential Summary" and begins with a 
you-will-learn and a what-why-how section. The latter are not 
very useful: why use the menu system? why handle events? 
why use compiler and runtime errors? The answers are obvi¬ 
ous. 

The back cover claims the book contains "all the latest 
information on 32-bit programming, multithreading, OLE 
automation, file input/output, multimedia. Visual 
Component Library, component building, debugging, and 
optimizing your code." But only 5 pages are devoted to 32-bit 
programming, 4 to multithreading, 6 to OLE, 5 to file I/O, 
none to multimedia, 84 to the VCL (descriptions, placing, siz¬ 
ing, etc.), 12 to debugging, and 3 to code optimization. 


Novice programmers won't find this book very useful: it 
focuses on the easy and unimportant and ignores the more 
difficult but important; there are only a few code fragments; 
and the index is fair at best. In Chapter 12, Manning describes 
each compiler option, but doesn't explain any of them. If you 
need to know whether or not you should turn on the stack 
frames option — or even what it does — you won't find out 
here, but you will learn where it is and how to check it. 

On pages 28 and 47, Manning discusses Repository 
options, but the Repository itself isn't explained until Chapter 
21 (about 160 pages later). This is a common problem in books 
that lack organizational structure. 

A short "guide" focusing on the differences between 
Delphi 1.0 and 2.0 — especially those that resulted from the 
change to 32 bits and the Win95 GUI — could be useful. But 
this book doesn't do that. Although Borland's Official No- 
Nonsense Guide to Delphi 2 is well written and well edited, I 
can't think of anyone who would benefit by purchasing it. 
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322 pages 
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That's right, it really has been 20 years since the first publi¬ 
cation of this book. What relevance could a 20-year old book 
on programming have today? A lot, since it turns out that 
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many fundamental problems associated with programming 
have changed little in 20 years, and this book said a great 
many things first and best. 

The last time I was other-employed (the unnatural state of 
not being self-employed), the programming team I was on 
was asked to estimate a completion date for the next version 
of the product. Our first estimate did not land before Comdex, 
so we were directed to produce another estimate — you know 
the routine. I dug out my old copy of this book, photocopied a 
section labeled "Gutless Estimating," and posted it to the wall. 
That little section says, in part: 

An omelette, promised in two minutes, may appear to be pro¬ 
gressing nicely. But when it has not set in two minutes, the cus¬ 
tomer has two choices — wait or eat it raw. [. . .] false schedul¬ 
ing to match the patron's desired date is much more common 
in our discipline than elsewhere in engineering. [...] Until esti¬ 
mating is on a sounder basis, individual managers will need to 
stiffen their backbones and defend their estimates with the 
assurance that their poor hunches are better than wish-derived 
estimates. 

When I posted that little snippet, I also noted that the book 
from which it was taken was more than a decade old. Twenty 
years ago, Brooks did a masterful job of summarizing the 
worst aspects of programming, and quoting his words did 
more to point out the absurdity of what we were doing than 
any amount of arguing I could do. 


This anniversary edition is a tasteful update. It includes the 
original text, augmented with new thoughts and reflections 
on the past. The opinions that the author has changed or kept 
after 20 years make for fascinating reading. The famous "No 
Silver Bullet" paper that Brooks published in 1987 is included. 
If you've never read this book, now is a great time to buy it. If 
you read the original, it's well worth buying the update and 
reading the new material. Every professional programmer 
should own a copy of this updated classic. 
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Rich Grace 
313 pages 
Prentice Hall, 1996 
$48.00 

ISBN 0-13-341801-4 



Here's a great example of the kind of book we need more 
of — a book that tackles a specific, well-defined subject. In 
this case, the subject is benchmarks for computer systems 
and applications. These are the sorts of benchmarks a large 
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organization might use in evaluating systems before making a 
major technology investment. Areas covered include SPEC 
networking benchmarks, Ziff-Davis networking benchmarks, 
transaction processing performance council benchmarks, Neal 
Nelson & Associates benchmarks (UNIX), AIM Technology 
benchmarks (UNIX), Ziff-Davis PC benchmarks, Windows 
benchmarks, Graphics Performance Characterization 
Committee benchmarks, SPEC benchmarks, and scientific and 
kernel-based benchmarks. 

The book doesn't just enumerate benchmarks; it gives you 
the history and perspective you need to understand the rele¬ 
vance of the benchmarks. When should you care how fast 
your system performs the Whetstone benchmark? When 
should you ignore Whetstones and instead focus on how fast 
your system runs WinBench 96? Who made these bench¬ 
marks, and what was the benchmark author's original intent? 
What benchmark can you use to decide if that DEC Alpha 
runs Windows NT faster than a Pentium Pro? The information 
presented is far from academic. The only weakness I found 
was an incomplete approach to listing the availability of each 
benchmark — "commonly available on the Internet" is not as 
nice as providing a specific URL or contact point. 

If you make or influence system purchases, this book is a 
good bet. Also, many of these benchmarks were created years 
ago, so if you've ever wondered exactly what a Dhrystone or a 
BYTEmark is, this is a handy reference. 


buy two $49.95 books that together cover much less ground. If 
you've ever needed a book on graphics file formats, I highly 
recommend this one. 
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[Editor's note: this book was reviewed by George Tylutki.] For 
advanced Delphi users, this book "provides insight into 
advanced topics like proper business rules deployment and 
concurrency control" and for beginners it "covers entry-level 
topics like database design and the building blocks of Delphi 
database applications." 

In Chapter 2, Henderson compares Object Pascal to C, C++, 
Visual Basic, PowerBuilder and the xBase dialects — data 
types, operators, procedures and functions — and gives spe¬ 
cific information that will "assist you in moving to Delphi 
from other environments." Depending upon your back¬ 
ground, this chapter alone may be worth the price of the book. 
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This js the best reference for graphics 
file-formats. Period. I reviewed the first 
edition of this book in the November 
1994 issue of Windows Developer's 
Journal and it was the best reference on 
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added more file formats, improved 
their coverage of Windows file formats, 
and even have a Web support site to 
keep you updated with new file format 
information. 

The book itself contains a thorough 
introduction to relevant concepts of 
graphics file formats, followed by a 
synopsis of each graphics file format. 
The CD-ROM contains, whenever pos¬ 
sible, the complete specification of the 
file format, along with an HTML ver¬ 
sion of the book so you can use your 
favorite browser to scan the book. The 
book costs $79.95, but you can easily 
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Chapter 14, "The Windows API," contains useful material, 
especially if you're new to Windows programming or have 
been using another language to program for Windows. 
Chapter 15, "Interfacing with Other Applications," is a thor¬ 
ough treatment of sending messages to and receiving mes¬ 
sages from other applications, DDE, and launching other 
applications from yours and determining when they close. 

In Chapter 16, "32-Bit Delphi," there is a little on this and a 
little on that. Chapter 17 discusses the differences between 16- 
and 32-bit DLLs, how to reduce their size, exception trapping 
considerations, and more. Chapter 18 contains some good 
information about optimizing Delphi 1.0 and 2.0 applications. 
Appendix A explains some of Delphi's error codes, which is 
useful because their causes are not obvious. There is also a 3- 
page bibliography. 

The major weakness of the book is that it was rushed into 
print. It should be better organized and less repetitious. There 
are erroneous cross-references and unnecessary illustrations. 
It's pointed out in Chapter 8 that "all the driver information 
provided in the following sections is specific to Delphi 1.0." 
The DLL component in Chapter 10 "isn't Delphi 2.0-compati- 
ble" and the TDBOleContainer component of Chapter 11 "will 
not run under Delphi 2.0." In Chapter 15, LoadModul e (), 
WinExecO, and Shel 1 Execute!) are discussed, but 
CreateProcesst) is not, "since at the time of writing, Delphi 
was only 16-bit". The authors claim that their access to only a 
beta version of Delphi 2.0 limited their coverage, but this is an 


excuse, not a reason. It would have been better to change the 
book's title (and the cover's claims) or to delay publication. 
Still, the book contains a huge amount of useful information, 
most — but not all — applicable to Delphi 2. 

The back cover claims the book was "written by a plethora 
[sic] of experts," but there are only nine authors. The quality of 
the writing varies from chapter to chapter; none of it is above 
average and some is decidedly below. Overall, there are over 
200 run-on sentences. 

Since it is clearly the intention of the authors that you use 
their code in your projects, the statement on the inside back 
cover ("Programs, files and images [on the CD] are not for 
redistribution without express permission from Wrox Press") 
apparently refers to shipping the files as-in (with your own 
book, for example). But only a lawyer knows for sure. 
Updates are available from an Internet site. 

The CD contains the entire, searchable text of the book (a 
great idea), which is good, because the index is only fair. Also 
included are commercial and shareware components and 
applications too numerous to list and a number of FAQ and 
other text files. Unfortunately, there is no file that describes 
each item and too many of the files date to the release of 
Delphi 1.0 ("Wow! I just got Delphi and it's great"). Some of 
them are still useful, but they should have been edited, not 
just included. 

Despite its shortcomings. The Revolutionary Guide to Delphi 
2 is a pretty good general, non-introductory book on Delphi. 
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Let's Talk Books 

From: Tonko Juricic <tony@iac.net> 

Dear Ron, 

Even if two books go together just fine, Windows++, part of 
the Andrew Schulman programming series, was written by 
Paul DiLascia, not by Jeff Prosise. Except if this is the same 
guy using two different names. 

Anyway, I did not read the whole book yet, and even if I 
have some reservations about the books that try to teach 
Windows and go into the details at the same time, Jeff seems 
to have done an exceptional job. My first impression is that 
it is important for a seasoned Windows programmer to 
resist the tendency to skip over the pages that look like 
nothing more than a rephrased SDK or MFC documenta¬ 
tion. I found lots of little details hidden there and scattered 
all over: those little details that you were never 100 percent 
sure of or thought you knew and understood fully, but real¬ 
ly did not. 

I can't tell you how many people wrote in to point out that I had 
mistakenly attributed Windows++ to Prosise (the author is 
DiLascia, as you mention). Clearly, when people find a good book 
they remember the author's name! 

My copy of Prosise's real book, Programming Windows 95 
with MFC, arrived a few days ago, so I'll soon start going over it 
and hope to print my impressions in next month’s column. Sounds 
like you're pretty happy with it so far. —rib 


launch about another book from the same authors. It is OLE 
Controls For VB4, an indecorous sequence of buttons to press 
and trivial code fragments illustrating the use of a family of 
OCXs developed by TegoSoft Inc. The book claims to be use¬ 
ful for learning how to use 20 powerful OLE controls, as 
well as to create your own. It enumerates 19 chapters but 
just the last three deal with the creation of new OCXs. For 
the authors, an OCX is defined thus: "An OLE Control is a 
file with an .OCX extension (for example, My Button. OCX)." 
(Chapter 1, page 2.) It's incredible how many lies there are 
in the real world about OLE being hard and complex to 
understand. Then you buy this $39.99 book and discover 
that an OCX is just a file with .OCX extension! Powerful. 

But you might think this is just a sentence extracted from 
a consistent argumentation. You're wrong. There is more. 
There is no mention along the entire text of trifles such as 
COM model, OLE server, MFC classes for creating OLE con¬ 
trols and it seems that the authors have no idea at all of what 
actually an OLE control is. They give you your cookbook, 
follow the instructions (click here, drag there, press some¬ 
where), and go. A programmer needs something more. I 
think that books like this are worth your effort for preparing 
the talk proposed to Software Development '96 in spite of 
the rejection. "How to write truly awful programming 
books," a feast for my ears! 

Despite the manifest awfulness of the book, I tried to put 
into practice all the instructions, and I succeeded in creating 


Ron, 

Yesterday, I read your review on Michael Tischer's PC 
Intern book and your comments on German books in general. 
Well, from my point of view, the story is completely different. 
Scanning through the bookshelves of German book stores, 
there's so much crap that it's hard to find the good stuff in 
between. I'm usually buying books from US authors in origi¬ 
nal language only. German books are either poor translations 
of English writings, or incorrect compilations of information 
from various sources decorated with an enormous amount of 
typos and buggy diagrams. Terrible! 

There are only a few exceptions; for instance, PC- 
Hardwarebuch by Hans-Peter Messmer, whose translation to 
English has some reputation over in the states. 

Ciao, 

Sven 
100557,177 
Herzogenaurach, Germany 

Well, I guess I’m relieved to hear that German programmers are 
not just better authors than us, as I had speculated. I definitely liked 
Messmer's book, though I haven't seen the overdue update that cov¬ 
ers the Pentium. Thanks for the on-site feedback! —rib 

Hi Ron, 

The following is what I think about a very, very bad book: 
OLE Custom Controls for VB4, by O. Gurewich and N. 
Gurewich, SAMS Publishing. 

I read in the April 1996 WDJ a warning about a book by 
Ori and Nathan Gurewich How to create Real-World 
Applications with Visual Basic. I have a similar warning to 
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my first OCX with not much effort. But there is more. 
Reviewing this book for an Italian programming magazine, I 
explained its pros and cons this way: 

Pro: My wife, who studied Medieval Literature, was also 
able to create her OCX; namely, the instructions were 
right. 

Con: My wife, who studied Medieval Literature, was also 
able to create her OCX; namely, all the credits go to 
Control and Class Wizard, but they are not provided by 
Gurewich and Gurewich. 

Either my wife has a brilliant future as programmer or we 
found a countersample demonstrating that this is a book for 
beginners, not for experts. Yes, a book for beginners — for the 
people who don't know the authors yet. 

And last but not least, a book targeted to expert program¬ 
mers contains a ridiculous appendix with a tutorial on how to 
write your first VB program. Were those 27 additional pages 
really necessary? But, indeed, the real question should be 
"Was this additional book really necessary?" My answer is a 
loud and clear NO. 

You must be psychic, as the exploits of Gurewich and 
Gurewich were to have been featured in my torpedoed "How to 



J SDK Annotation #139 

TYPE: Win16 
TOPIC: EM_SETSEL 
KEYWORD: EM_SETSEL 

The SDK documentation mentions that if 
wParam is 0, the caret is scrolled into view, and 
if wParam is 1 it is not scrolled into view. 
However, this parameter is not used for single 
line edit controls. 

Also, the order of the start and end positions 
specified in the IParam is not respected by 
single line edit controls. 

Both wParam and IParam work as documented 
for multiline edit controls. 

Reference: MSDN PSS Q102641, Q64758. 

Submitted by:V. Ramachandran. 

Gel the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 


Write Truly Awful Programming Books" class. I should make it 
clear, as I have with past G&G clinkers, that I have nothing 
against using a book to market your software — it's the practice of 
disguising a book about a commercial product as a more general- 
purpose programming book that lands their books in the Books in 
Brief "Hall of Shame." 

After examining this book myself, I do have to disagree some¬ 
what with your assessment. The title OLE Controls for Visual 
Basic 4 is not outrageously misleading about the contents, espe¬ 
cially if you read the subtitle ("Learn to use more than 20 power¬ 
ful OLE controls for Visual Basic"). The authors (or perhaps the 
publisher?) have come a long way from their earlier efforts, when 
they would claim to teach multimedia programming while merely 
presenting instructions on how to call crippled versions of 
TegoSoft VBXs (send in more money to get rid of that nag 
screen!). It's true, the "20 powerful OLE controls" are a little lame 
(but didn't you smile when you saw the powerful "dice" control, 
which displays a pair of dice you can actually roll — think how 
much time that control alone will save most programmers!). It's 
also true, the book cover claims you will "learn how to create your 
own OLE controls," while the book really only teaches you hozv to 
push wizard buttons. But this is hardly exceptional; the claim to 
teach OLE has become as ubiquitous to programming books as 
espresso stands are to Redmond. If this book is any indication, I 
think that Gurewich and Gurewich have moved from creating 
notoriously bad programming books to creating merely mediocre 
books that do not distinguish themselves from the awful average 
we’re all used to. It makes me a little sad, really. —rib O 



J SDK Annotation #140 

TYPE: Win32 
TOPIC: STGM 
KEYWORD: STGM 

The documentation fails to mention that for all 
storage and stream creation functions, you 
HAVE to specify a share mode flag. For 
example, a call to StgCreateDocfile with 
STGM_CREATE I STGM_READWRITE will 
fail; while passing STGM_CREATE I 
STGM_SHARE_EXCLUSIVE I 
STGM_READWRITE will work correctly. 

Submitted by:V. Ramachandran. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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Mercury Interactive Ships WinRunner 4.0, TestSuite 4.0 


to Miller Freeman, Inc. 
1601 W. 23rd St. 
Suite 200 
Lawrence, KS 66046 
fax 913-841-2624 


WinRunner 4.0, a GUI testing tool, automates both test 
creation and test execution. The testing technology, called 
RapidTest, enables users to create test plans and test scripts 
using automated test generation techniques and wizards. 

WinRunner 4.0 features include RapidTest Script 
Wizard that navigates the entire user interface of the 
application being tested to automatically develop GUI test 
scripts, a visual testing environment that organizes auto¬ 
mated testing facilities, built-in exception handling, and 
an open API for user-defined custom object testing. 


WinRunner 4. 0 supports Windows 3.1, Windows 95, 
and Windows NT, and is available both as a standalone 
package and as part of Mercury Interactive's TestSuite 4.0. 

The Standard Edition of WinRunner 4.0 (for Windows 
3.1) is $2,850; The Professional Edition of WinRunner 4.0 
(with support for Windows 3.1,95, and NT) is $3,995. 
TestSuite 4.0 starts at $3,495. For more information, contact 
Mercury Interactive at 470 Potrero Ave., Sunnyvale, CA 
94086; 408-523-9900; fax 408-523-9911; www.merc-int.com. 


wdletter@mfi.com 


Sylvan Ascent, Inc. Upgrades SylvanMaps/OCX 


New features of the upgraded SylvanMaps/OCX 
include faster runtimes; smaller map database size; an 
improved display that prevents street and other labels 
from overlapping each other or displaying upside down; 
Visual Basic printing using the PaintPicture print method; 
bitmap and metafile support; 32-bit versions of 
SylvanMaps/OCX utilities; additional translators, includ¬ 


ing Arc View Shape Files, USGS DLG, and AutoCAD 
DWG files; and simplified installation and instruction. 

SylvanMaps/OCX vl.20 is $495. For more information, 
contact Sylvan Ascent, Inc., P.O. Box 4792, Santa Fe, NM 
87502; 800-362-8971 or 505-986-8739; fax 505-986-0906; 
74774.3322@compuserve.com; CompuServe: 
GOSYLVANASCENT; www.sylvanmaps.com/ocx. 


Blue Sky Adds Support for ActiveX Technologies 


Blue Sky Software has released Active Web, an ActiveX 
Control that provides access to the Internet directly from 
Windows applications, and ActiveHelp, an enhanced ver¬ 
sion of the SmartHelp OLE Control. 

The ActiveWeb Control creates a button into any 
Windows application to jump directly to any World Wide 
Web site or Intranet site. Application users can also down¬ 
load any file from the Internet or send email. The 
ActiveWeb Control supports all major Web browsers. 

The ActiveHelp Control, an enhanced version of the 
current SmartHelp OLE Control, eliminates the need to 
program context-sensitive Help into any Windows appli¬ 
cation developed with Visual Basic 4.0, Visual C++ 4.1, 


Access 95, and Visual FoxPro 3.0, or other development 
environments supporting the ActiveX or OLE Control 
standard. 

Using the ActiveHelp control, software developers 
drag and drop the included Help button into any Visual 
Basic 4.0, Visual C++ 4.1, Access 95, and Visual FoxPro 3.0 
application. The Help button is automatically linked to the 
selected topic and the context-sensitive Help link is creat¬ 
ed between the application and the Help file. 

ActiveWeb and ActiveHelp each cost $149. For more 
information, contact Blue Sky Software, 7777 Fay Ave., 

Suite 201, La Jolla, CA 92037; 800-459-2356 or 619-459-6365; 
fax 619-459-6366; www.blue-sky.com. 
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Simply Solutions Ships Visual DLL v2.0 

Simply Solutions has released Visual DLL 2.0, an 
upgrade of its product for creating standard Windows 
DLLs with Microsoft Visual Basic. A new feature is the 
ability to create 32-bit DLLs compatible with Windows 95 
and Windows NT. 

Visual DLL creates true Windows DLLs that can be 
called from low-level languages such as C and C++. 

Visual DLL automatically creates C header file and Basic 
declare statements for access from third-party applica¬ 


tions. In addition, by creating binary library modules for 
distribution to customers and third-party developers, the 
source code does not have to be given out to provide the 
particular functionality of a module. 

Visual DLL costs $249.95. For more information, con¬ 
tact Simply Solutions, 930 Tahoe Blvd., #8021374, Incline 
Village, NV 89451; 800-355-2405 or 310-575-5047. 
CompuServe: GO SIMSOL; simply@netcom.com. 


EarthTrek's Conversion Assistant Supports VB 4.0 


EarthTrek Inc. has released Conversion Assistant 3.5 
that supports conversion of Visual Basic 4.0 applications. 
This version also features a simpler wizard-like interface. 
The Conversion Assistant enables developers to migrate 
Microsoft Visual Basic applications to Borland's Delphi. 
The Conversion Assistant reads Visual Basic project and 
program files and creates a mapping to the equivalent 
files that can be read, modified, and executed within the 
Delphi environment. 

The Conversion Assistant reads the Visual Basic . raak 


(or . vbp), . f rm and . sas files and provides a "best fit" 
translation to the Delphi format . dp r, . df k, and . pas files. 
Conversion of form files can be customized using a map¬ 
ping file that allows the user to specify translation of cus¬ 
tom controls and property names. 

Conversion Assistant 3.5 is $99 for the standard edi¬ 
tion and $149 for the database edition. For more infor¬ 
mation, contact EarthTrek, 7 Mountain Rd., Burlington, 
MA 01803; 617-273-3038; fax 617-270-4437; 
72321.742@compuserve.com. 


MicroHelp Announces Game+Multimedia X-ponents 


Game+Multimedia X-ponents, a package of program¬ 
ming objects, encapsulates the Microsoft DirectX pro¬ 
gramming interfaces. Game+Multimedia X-ponents con¬ 
tains MhDirectDraw, MhDirect, Sound MhDirectPlay, 
MhDirectlnput, Mhlmage, MhAVI, and MhWave. These 
component families provide direct access video memory 
and the bit manipulation capabilities of the hardware, 
enable hardware and software sound mixing and play¬ 


back, provide connectivity of games over a modem link or 
network, and provide control of display, multimedia, and 
audio. 

Game+Multimedia X-ponents retails for $249 but is 
available for an introductory price of $189. For more infor¬ 
mation, contact MicroHelp, Inc., 4211 J.V.L. Industrial 
Park Dr. NE, Marietta, GA 30066; 800-777-3322 or 
770-516-0899; fax 770-516-1099; ivww.microhelp.com. 


Diamond Head Software Updates ImageBASIC Products 


Diamond Head Software has upgraded its 
ImageBASIC Products to include ImageBASIC 3.0, an 
upgrade that adds an integrated suite of ActiveX Controls 
to its line of document imaging and workflow compo¬ 
nents and applications; and Electronic File Cabinet, a stor¬ 
age, indexing, and retrieval imaging application. 

ImageBASIC 3.0 components come in three initial ver¬ 
sions: 32- and 16-bit ActiveX Controls and 16-bit VBXs, sup¬ 
porting Windows 3.x, Windows 95, and Windows NT. (The 
ActiveX technologies were previously known as OLE 
Controls.) Version 3.0 also includes advanced scan, display, 
print, recognition, and forms processing components. 


Syware Updates ODBC Driver Kit 

Syware, Inc. has updated Dr. DeeBee's ODBC Driver 
Kit. The Bronze Edition enables construction of ODBC dri¬ 
vers for legacy and proprietary databases, allowing these 
databases to be used with other database tools such as 
Access, Visual Basic, PowerBuilder, and Crystal Reports. 
The upgrade adds sorting capabilities, support for addi¬ 
tional ODBC datatypes, BCD arithmetic, and SQL 
passthrough capabilities to the current Standard Edition. 


Electronic File Cabinet includes the Visual Basic 4.0 
source code, giving users the ability to choose the data¬ 
base and image server that best meets the application's 
needs. With Electronic File Cabinet, imaging applications 
can also be integrated with off-the-shelf business applica¬ 
tions like MS Word or Lotus Notes. 

ImageBASIC 3.0 costs $1,750. The Electronic File 
Cabinet costs $2,500, which includes source code. For 
more information, contact Diamond Head Software, Inc., 
1217 Digital Dr., Suite 125, Richardson, TX 75081; 
800-428-6657 or 214-479-9205; fax 214-479-0219; 
www.dhs.com. 


The Dr. DeeBee ODBC Driver Kit, Bronze Edition, con¬ 
tains Win32 source code that provides an SQL parser, 
semanticizer, query processor, and all ODBC housekeep¬ 
ing functions. 

The Bronze Edition of the ODBC Driver Kit is $3250. 
For more information, contact Syware Inc., P.O. Box 91 
Kendall, Cambridge, MA 02142; 617-497-1376; 
fax 617-497-8729; www.syware.com. 
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LBMS Announces InSight 1.0 

LBMS, Inc. announced InSight 1.0, an object manage¬ 
ment tool to implement Software Configuration 
Management (SCM) and repository capabilities for com¬ 
ponent-based development. Designed as an OLE-based 
object repository, InSight provides developers with tools 
to manage, understand, and reuse development compo¬ 
nents in object-based client/server environments. 

InSight 1.0 offers bi-directional integration with Visual 
Basic 4.0, enabling developers to access most day-to-day 
object management operations directly from their devel¬ 
opment environment. The product also supports files and 


OLE objects, such as Microsoft Word documents. InSight 
is integrated via OLE with LBMS Systems Engineer, a 
client/server modeling environment, and with LBMS 
Process Engineer, an enterprise process management tool. 

InSight 1.0 is available at an introductory price of $249. 
A 30-day free evaluation can be downloaded from 
www.lbms.com. InSight 1.1, due out in late summer, will 
be $695 per seat. Insight 1.0 users will receive free 
upgrades. For more information, contact LBMS, 1800 W. 
Loop S„ Houston, TX 77027-3210; 800-231-7515 or 
713-625-9334; ivwzv.lbms.com. 


20/20 Software Introduces NET-Install and v4.1 of PC-Install 


20/20 Software has introduced version 4.1 of PC- 
Install, installation software for DOS, Windows 3.x, 
Windows 95, and Windows NT; and NETInstall, a PC 
installation program designed to support distribution and 
setup of software and data files via the World Wide Web. 

Version 4.1 of PC-Install provides a way to distribute soft¬ 
ware and data files into DOS, Windows 3.x, Windows 95, 
and Windows NT environments. At no charge to registered 
users of Version 4.0, version 4.1 adds the ability to bind 
together multiple program, system, and data files for single¬ 
file distribution over the Internet or other online service. 


For software publishers, 20/20 Software provides 
Publisher's Toolkit with NETInstall. Publishers Toolkit 
gives the user tools that provide the ability to customize 
the look and features of any installation, check the end 
user's system for adequate resources, and provides a pass¬ 
word-checking option so that publishers can protect their 
files on an Internet server. 

NET-Install costs $299. PC-Install costs $249; upgrades 
are $79. Contact 20/20 Software, 8196 SWHall Blvd., 
Suite 200, Beaverton, OR 97008; 503-520-0504; 
fax 503-520-9118; www.twenty.com. 


XCeed Releases 32-Bit Zip Compression Library for Delphi 2.0 


The upgrade of the 32-bit Zip Compression Library 
allows developers to add zip compression and decom¬ 
pression to their Windows applications. The library comes 
with visual components for Visual Basic, Delphi 1.0, and 
Delphi 2.0. Users are able to monitor current compression 
activity and are prompted by the library when decisions 
need to be made. 

The Xceed Zip Compression Library is compatible 
with the latest. z i p file format. It uses its own compression 


engine to create, extract, fix, list, test, and update .zip files 
in the Windows 3.x, Windows 95, and Windows NT envi¬ 
ronments. A trial version is available and can be down¬ 
loaded from www.xceedsoft.com. 

The XCeed Zip Compression Library costs $199.95. For 
more information, contact Xceed Software Inc., 345-A 
De Gentilly Est, Lottgueuil, Quebec J4H1Y7 Canada; 
514-442-2626; fax 514-442-4604; www.xceedsoft.com. 


InstallShield Announces DemoShield4 for Windows 


DemoShield4 for Windows, the latest version of the 
InstallShield demonstration toolkit, creates Windows- 
based demonstrations with interactive text and graphics. 
DemoShield4 adds video and static screen capture capa¬ 
bilities, additional online design guidance, and features 
that use Windows 95 interface conventions. Its built-in 
tools enable users to create, capture, control, and sequence 
scenes without any programming or scripting. 

Demo options include a live application capability that 
enables viewers to interact with a live application that 

Excel Software Ships WinA&D 1.0 

WinA&D 1.0, a family of computer-independent soft¬ 
ware modeling (CISM) products for Windows 95 and 
Windows NT, provides system analysts and software 
designers with comprehensive software engineering 
methods, including object-oriented analysis and design 
(OOA/OOD), structured analysis and design, realtime 
and multitask design, data modeling, integrated code 
editing and browsing, requirements traceability and use 
cases, multiuser team dictionary, and team requirement 
documents and code generation. The OOA/OOD support 


runs entirely within the demo. Other options include ani¬ 
mated playback, static screen capture, and the ability to 
layer text, graphics, and points over application screen 
shots. Design process features include the ability to apply 
motion effects to several objects simultaneously. 

DemoShield4 for Windows costs $495, but is available at 
an introductory price of $195. Upgrades are $195. For more 
information, contact InstallShield, 1100 Woodfield, Suite 
108, Schaumburg, IL 60173; 800-374-4353 or 847-240-9111. 


includes the Booch, OMT, Shlaer/Mellor, Coad/Yourdon, 
Jacobson, and Fusion methods. Users can pick and mix 
the best aspects of each method and do customization 
with many diagram style options, templates, and a user- 
definable symbol library. 

WinA&D Desktop is $1,295; WinA&D Developer is 
$1,995; and WinA&D Educational is $895. Prices are for 
single-user licenses. For more information, contact Excel 
Softzvare, P.O. Box 1414, Marshalltown, IA 50158; 
515-752-5359; fax 515-752-2435; casetools@aol.com. 


September 1996 


Windows Developer's Journal — Page 71 




IBM's VisualAge Now Supports NT and 

IBM has added support for Windows NT and 
Windows 95 to VisualAge for C++. The new VisualAge for 
C++ for Windows version features IBM Open Class 
Library, a library of prebuilt components that can be 
assembled into portable applications. The library incorpo¬ 
rates compound-document framework technology from 
Taligent. Frameworks provide a structure for reusing 
application designs and code built from predefined 
objects. Taligent's Compound Document Framework 
(CDF) simplifies Object Linking and Embedding (OLE) 
programming by enabling developers to create OLE appli¬ 
cations with as few as two or three lines of code. 

VisualAge for C++ for Windows provides an integrated 
C++ development environment that includes a data access 


95 

builder that automatically generates objects and parts for 
accessing relational data. The data access builder has been 
enhanced in the VisualAge for C++ for Windows release to 
support Open Database Connectivity (ODBC). In addition 
to native support for DB2 for Windows NT, this builder 
can access Oracle, Sybase, and other relational databases 
supported by ODBC. VisualAge for C++ for Windows also 
includes an optimizing compiler that supports the Pentium 
ProChip, a syntax-highlighting editor, class browser, pro¬ 
gram debugger, and performance analyzer. 

VisualAge for C++ for Windows costs $449. Upgrades 
start at $225. For more information, contact IBM at 1133 
Westchester Ave., White Plains, NY 10604; 800-426-3333; 
www.software.ibm.com. 


Mabry Software Ships MIDI Pack for VB 


Mabry Software has shipped its new MIDI Pack of cus¬ 
tom controls designed for use with Microsoft Visual Basic. 
This package includes controls to receive and send MIDI 
data (including Sysex/system exclusive data), and to 
manipulate MIDI files. Also included are user interface 
controls for MIDI applications. 

All of the controls in the MIDI Pack come in three dif¬ 


ferent styles of controls: VBX, 16-bit OCX, and 32-bit OCX 
(ActiveX). The different styles of controls are all available 
in the same package. 

The MIDI Pack costs $99 ($299 with source). For more 
information, contact Mabry Softzvare, Inc., P.O. Box 
31926, Seattle, WA 98103-1926; (206) 634-1443; 
fax 206-632-0272; 71231.2066@compuserve.com. 


QSI Ships ProTEST 3.5 

QSI has shipped ProTEST 3.5, a test process management 
system designed to assist in the development of a formal and 
structured test methodology as well as manage the testing 
process. Enhancements include the ability to assign weight 
factors to a test case procedure, test case summary reports 
that provide detailed status of the test case, and an online 
"Regression Testing - To Do" file that allows direct access to 
the test cases that have failed in order to include them as part 
of the Regression Test Phase of the project. Additional 
enhancements include test case status update capabilities 


that allow testers to pick and choose which test cases to 
update with a Pass/Fail or Incomplete status, and a Quick 
View function that provides a display of all the test case pro¬ 
cedures in one screen along with the associated require¬ 
ments, problem report numbers, description of the proce¬ 
dures, and the status of each individual test case procedure. 

Prices for ProTEST 3.5 start at $695. For more informa¬ 
tion, contact Quality Systems International, Inc., 416-420 
Highland Ave., Cheshire, CT 06410; 800-557-9787 or 
203-699-9787; fax 203-699-9789. 


Rational's SoDA Now Available on Windows 


Rational Software Corporation has announced that its 
documentation tool SoDA is now available on Windows. 
SoDA automates software documentation for the Rational 
Rose family of graphical object modeling tools. SoDA, built 
on both Microsoft Word and FrameMaker+SGML, allows 
developers to automatically generate software documenta¬ 
tion from their graphical object models and from their code. 

With SoDA, users can automatically create documenta¬ 
tion of their design and code, with information automati¬ 
cally extracted from Rational Rose. Users work within 


Word or FrameMaker and select SoDA commands from 
the SoDA menu. They can generate complete documents 
with placeholders for supplemental information that can 
be added using the publishing application. 

Prices for SoDA start at $1,995, which includes one 
year of support. For more information, contact Rational 
Software Corp., 2800 San Tomas Expressway, Santa 
Clara, CA 95051-0951; 800-728-1212 or 408-496-3600; 
fax 408-496-3636; product_info@rational.com; 
www.rational.com. 


DataViews Announces DV-Centro 1.2 for Windows NT 


DataViews Corporation announced DV-Centro 1.2, a 
development tool for building Visual Programming 
Languages (VPLS) under Windows NT. DV-Centro allows 
programmers to create true VPL systems based on custom 
symbols, shapes, and objects connected to data. Based on 
an object-oriented C++ framework, DV-Centro features a 
suite of graphical tools that allow users to create reusable 
components for complex VPL applications. Also featured 
is an Interactive Control Engine that manages events 
between the user display and the application components. 

DV-Centro 1.2 features a set of coordinated C++ classes 
optimized for managing the relationships between graph¬ 


ics and data in VPL applications. This framework decreas¬ 
es the amount of code that must be programmed, tested, 
and debugged. DV-Centro also includes a set of C++ utili¬ 
ties for memory management, infinite undo/redo, object 
storage/retrieval, and journaling. 

DV-Centro 1.2 supports Windows NT 3.51 with 
Microsoft's Visual C++ compiler, HP-UX 10.x, and Sun 
Solaris 2.4 with a native C++ compiler. 

Development seats for DV-Centro begin at $15,000. 
For more information, contact DataViews Corp., 47 
Pleasant St., Northampton, MA 01060; 413-586-4144; 
fax 413-586-3805; info@dvcorp.com; wivw.dvcorp.com. 
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Blue Sky Ships Visual SQL 



Blue Sky Software has announced a new version of 

Visual SQL that extends Visual C++ with visual designers, 
wizards, and object-oriented data access, creating a visual 
client/server development environment without leaving 
Visual C++'s familiar environment. 

Based on industry standard C++, Visual SQL uses the 
32-bit Visual C++ native code compiler and is optimized 
for Windows 95 and Windows NT. Fully integrated with 
Microsoft Developer Studio, developers can create, modi¬ 
fy, compile, and run client/server applications inside 
Microsoft Developer Studio. 

The Visual SQL Tools provide for definition of queries, 

SQL statements, tables, pick lists, custom screens, and 
access to all database objects from a central component 
repository. The Visual SQL AppWizard expands the func¬ 
tionality of Visual C++ App Wizard. The Visual SQL 

AppWizard builds on the MFC classes provided by Visual 

C++ and adds classes specific to client/server applications. 

Visual SQL costs $1899, but is available at the introduc¬ 
tory price of $999. For more information, contact Blue Sky 

Software, 7777 Fay Ave., Suite 201, La Jolla, CA 92037; 

800-459-2356 or 619-459-6365; fax 619-459-6366; 
info@blue-sky.com; www.blue-sky.com. 


Eagle Research's JETset Links Delphi to Access 


Eagle Research has developed the new Delphi tool 

JETset that connects Delphi 2.0 to Access through JET, 
Microsoft's database engine. JETset provides support for 
Access database features such as transactions, stored 
queries, reporting, macros, and database repair, verifica¬ 
tion, and replication. JETset also supports JET's use of 
external data sources such as Excel and Lotus spread¬ 
sheets, Btrieve and FoxPro databases, and text files. 

JETset for Delphi requires Microsoft JET v3.0. Most pro- 

grammers who own the latest versions of Microsoft Visual 

C++, Visual Basic, or Access will already have this version of 

JET, along with appropriate documentation. 

JETset costs $150. It will be bundled at no cost with the 
professional edition of the VB2D Visual Basic-to-Delphi 
translator, which is $450. For more information, contact 

Eagle Research, Inc., 360 Ritch St., Suite 300, San 

Francisco, CA 94107; 415-495-3136; fax 415-495-3638; 
sales@xeaglex.com; www.xeaglex.com. 


DEL Softivare Announces Light Lib Magic Menus vl.Ofor Delphi 


DFL Software Inc. announced the release of Light Lib 
Magic Menus. This VCL offers Delphi developers an alter¬ 
native to the standard Windows menuing system. Delphi 
developers can now enhance their applications by adding 
background images, textures, bitmap menu items, and 
tool button palettes. Pulldown menus can display an 
image of a product, service, company logo, or a colorful 

texture in the background. 

Light Lib Magic Menus costs $99. For more informa¬ 
tion, contact DFL Software, Inc., 55 Eglinton Ave. E., Suite 

208, Toronto, Ontario, Canada M4P1G8; 

416-487-2660; fax 416-487-3656; BBS: 416-487-4041; 

CompuServe: GO DFLSW; 74326.1174@compuserve.com; 
www.dfl.com. 


AutoTester Now Available for Windows 

95 


AutoTester, Inc. has released AutoTester for Windows 95, 
an automated testing application. AutoTester for Windows 

95 includes integrated features that enable testing support 
for Windows 95 controls including sliders, column head¬ 
ings, list views, tree views, tabs, and spin boxes. 

Support for these controls is provided through 
AutoTester's visual testing component, AutoCommand. 

The AutoTester Scripting Language provides a command 
set for advanced scripting needs that can supplement cap¬ 
tured tests or that can be used to develop tests before com¬ 
pleting an application's code. 

AutoTester costs $2,800 per copy. For more information, 
contact AutoTester, Inc., 8150 N. Central Expressivay, Suite 

1300, Dallas, TX 75206; 214-368-1196; fax 214-750-9668. 


TurboPower Software Ships Orpheus 2.0 for Delphi 


Orpheus 2.0, an upgrade to the TurboPower Software 
Company's component library, features native Delphi con¬ 
trols including the data-aware grid and array editor con¬ 
trols as well as support for building validated data entry 
systems with Delphi. Orpheus 2.0 extends the user inter¬ 
face design capabilities of Delphi by supplying over two 
dozen components. Orpheus contains only native Delphi 
controls, eliminating VBX, OCX, or DLL distribution issues. 
Compatible with both Delphi 1.x and Delphi 2.0, Orpheus 
controls compile directly into your 16- and 32-bit . exe files. 

Orpheus 2.0 components include limitless listboxes, a 
calendar control, two- and four-way spinners, data-aware 
picture labels, notebooks with top and side mounted mul¬ 
tirow tabs, a text editor with 16Mb capacity and real-time 
wordwrap, and progress meters. 

Orpheus 2.0 costs $199; upgrades are $59. For more 
information, contact TurboPower Software Company, P.O. 

Box 49009, Colorado Springs, CO 80949-9009; 

800-333-4160 or 719-260-9136; fax 719-260-7151. 
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Readers' Forum 


Send letters to wdletter@mfi.com. 


Subject: WDJ July 96 
Greetings Mr. Burk. 

I was just reading your article on 
OLE Compound Files (WDJ, July 1996) 
and it is terrific. I just wanted to men¬ 
tion a little something about Unicode 
Strings/OLE/MSVC. For those of us 
using MS VC, instead of defining func¬ 
tions similar to your A2U() and U2A() 
functions, we can simply #i ncl tide 
<afxpriv.h>. That header file contains 
all the macros necessary for manipulat¬ 
ing Unicode OLE Strings under Win32. 
The USES_CONVERSION macro goes at the 
top of every function that uses the con¬ 
version macros. For example, 

USES_CONVERSION; 

PStg->0penStorage(T2C0LE(szObjectName)... 

Some macros are: 

• OLE converts from LPCTSTR to 
LPCOLESTR 

• E2CT converts from LPOLESTR to 
LPCTSTR 

• OLE converts from LPTSTR to 
LPOLESTR 

• E2T converts from LPOLESTR to 
LPTSTR 

Using these macros is great when you 
have the same app using ANSI strings 
under Win95 and Unicode strings 
under NT. Well, you probably knew all 
this already. 

I also was wondering about the code 
snippet at the very top of page 30. The 
first line reads, "IStream* * DataFile;". 
Should it not read "IStream’'' Stream;"? 
Thanks for your time. 

Sincerely, 

Mario Contestabile 
mcontest@universal.com 

I did not know about these macros, 
thanks for pointing them out! In general, I 
mostly have to write portable code, so I 
know little about any Microsoft-specific 
compiler features. You're also right about 
the error in my article. I really ought to 
know better than to ever run code snippets 


that are not cut directly from just-compiled 
code. I guess sometimes I just have to 
remind myself why I should obey my own 
rules! —rib 


From: Ross Virostko, ross@bellhow.com 
Topic: anntater.exe 

How do you get this to work with 
VC++ 4.x under NT? 

We let the Web copy of sdkann. zi p get 
out of synch with reality, but by the time 
you read this it should be up-to-date (in fact, 
it will have annotations that have not yet 
appeared in the magazine!). The latest ver¬ 
sion of sdkann.zip contains mstater.exe, 
which is a version of AnnTater designed to 
work with Visual C++'s proprietary help 
engine. This program is a 16-bit executable, 
so with a bit of luck it will work even on 
non-Intel versions of NT. These tools all 
work with extreme hackery (e.g., by simu¬ 
lating button presses and the like), so they 
are kind of fragile, but we've had okay luck 
with them so far. —rib 


From: Guy Gascoigne - Piggford 
[100136,1723] 

I was very interested in your article 
the July 1996 WDJ ("Compiler 
Benchmarks: new/delete"). We are cur¬ 
rently an MSVC 1.5x house and are 
looking to move to 32-bit in the near 
future, so your article raised quite a few 
comments. One question, though.When 
I looked at the MSVC 4.1 mal 1 0C( ) code, 
I noticed that, due to the heap checking 
that Windows performs, these functions 
may well run a great deal slower on the 
debug version of Windows than on 
release Windows. So, I've got to ask — 
were these benchmarks carried out 
under the debug version of Windows? 

Good question! Actually, I don't even 
have the debug version of Windows 95 
installed anywhere (shame on me), so these 
were run on the retail version. No vendor 
has disputed the basic results, so I have at 
least a little confidence at this point that the 
overall results are accurate. The results 
would also be somewhat different under NT, 
but right now I'm sticking to just making 


measurements under Windows 95 to keep 
things as simple as possible. The fact that 
the vendors see the benchmark ahead of time 
also helps detect any gross inequities — if a 
particular construct gave a gratuitous 
advantage to an individual compiler, the 
odds are decent that one of the other vendors 
would let me know. —rib 


From: Edward Clements [100256,3455] 
Re: Compiler Benchmarks, WDJ July 
1996 

Reading your article on Compiler 
Benchmarks in the July 1996 issue of 
WDJ, I was struck by the thought that 
conducting runtime speed benchmarks 
across compilers using only the default 
compiler options favors those compilers 
who have "speed optimizing" as the 
default option. I would be very interest¬ 
ed in the results when all compilers 
have their options set to the maximum 
optimization for speed. 

Another useful test would be debug 
version build times, since most of us 
developers spend most of our time 
(re-)building our sources in debug 
mode; this is probably where compil¬ 
ers with good incremental build algo¬ 
rithms would win out. Do you think 
you would have the (spare!) time to try 
this out? 

It was good to hear in your reply to 
Andre Vogel ("Readers' Forum," WDJ, 
July 1996) that you would continue to 
focus on the Windows API (this is 
another plug for MFC). Do you plan to 
post published and unpublished bug 
lists somewhere on Internet or 
CompuServe? 

For that particular benchmark, the com¬ 
pilation options should not matter at all 
because it carefully subtracts off the loop 
time in order to only measure the speed of 
the runtime library. In the benchmarks that 
followed, the options do matter, and we're 
using the options that should provide fastest 
generated code. 

I've thought about benchmarking build 
times, but I don't like any of the tests I've 
come up with. For example, Symantec is gen¬ 
erally faster than Visual C++ at building. 
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But is Symantec performing the same 
checks at compile time? No. And to specify 
that completely is very difficult — which of 
the dozens (hundreds?) of checks does each 
compiler do with a given set of command¬ 
line options? For example, under what con¬ 
ditions will Visual C++ detect which kinds 
of unreferenced variables? It seems very 
hard to me to make any meaningful com¬ 
parison, and I definitely do not want to 
reward compilers for being the fastest while 
doing the lousiest job of providing errors 
and warnings. 

I'm going to take a stab at keeping an 
online list of bugs that I've verified, so that 
we have a place for bugs that don't make it 
into Mark Nelson's Bug++ column. I've 
started working on a page at 

http://ourworld.CompuServe.com/homepages/RonBurk 



Developer's 

Marketplace™ 


Report woes? 

Slow, large, impossible? 


PrintForm 

Create complex, impossible reports. 

High quality documents, very well suited 
for form letters, reports and tables. Icons, 
bitmaps, texts. Fonts, word-wrapping, ali¬ 
gnment, headers, footers, numbering. DLL 
and C++ API. Demos in CompuServe: 
MSMFC or MSB ASIC 

DLL and source versions, 16- and 32-bit. 
30 day money-back guarantee. 

Cobasoft GmbH: CIS: 100010,204. Tel: +49-177-2194647 
Griffin Technologies Inc.: 800-986-6578, 913-832-2070. 
Fax: 913-832-8787, CIS: 71141,3624. 
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Only time will tell if I can actually 
manage to keep it updated, but it will be 
fun to try! -—rib 


From: Edward Diener 

I use all four C++ compilers 
(Borland, Microsoft, Symantec, and 
Watcom), but not on a daily basis. My 
editor is CodeWright and I think it is an 
excellent product. It has a fully pro¬ 
grammable API implemented (in 
Windows fashion) as extension DLLs 
using any language you want. It has a 
rich set of API functions. The base func¬ 
tionality of the editor is huge, support¬ 
ing practically every editing functional¬ 
ity you can imagine. The company that 
distributes CodeWright (Premia 
Corporation) is the most friendly, user- 
oriented software company ever. 


Premia is glad to get bug reports and 
always responds to them. Weaknesses? 
Occasionally, the CodeWright API is 
not fully documented and there is no 
good general explanation of each sec¬ 
tion of the API. Also, the API is strictly 
procedural, but, then again, so are the 
OSs it runs under (Windows 3.1, 
Windows 95, Windows NT, and OS/2 
Warp as a WIN/OS2 application). I 
don't think you can go wrong with 
choosing CodeWright as your editor. It 
is fully customizable and does just 
about anything you want it to do. 

Second note: OWL is superior to 
MFC in every way, shape, and form. If 
you want to run endless articles about 
MFC and if you want to tout VC++ 4.0, 
I can not stop you, but I sure as hell 
cannot renew my subscription to WDJ 


STOP WASTING TIME 
CREATING LIST BOXES! 

ListBox Calculator™ 

ListBox Calculator™ eliminates the tedious 
guesswork of setting up list boxes, combo 
boxes, and column headings. Easy to use for 
beginning through advanced programmers. 
ListBox Calculator automatically determines 

• List/combo box width 

• List/combo box tab stops 

• Column heading sizes and positions 

For all languages and most popular fonts 

$49 

Visa, MasterCard 

Sheet Bend Software 
4061 E. Castro Valley Blvd., #197 
Castro Valley, CA 94552 

Phone: 510 581 -2671 Fax: 510 581-8350 
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StarMaker Systems Inc. 

173 Thomson Ave., Regina, SK 
, X. Tel: (306) 596-2575 
^ www.starmaker-systems.com 

StarTools™ are new Paradox for Windows 
and Windows developers quality utilities. 


Available NOW - get your copies today! 

StarTime - FREE ! our network PC time synchronizer. 
StarCLID - PC Interface for TelCo Caller ID data. 

Available 4Q’96- reserve your copy now! 

StarDate - perpetual calendar with library connection to 
Paradox application forms. 

Captains Log - journal logging of application table 
changes. Full audit trails. Perfect for disaster recovery. 
LoadStar - checks PC configuration & pre-installed 
programs before allowing new program to install. 
StarLicence - counts & controls number of licensed 
users on networked PCs. 

StarLock - provides a lock for one or more Windows 
program groups for unattended PCs. Great for shows. 
StarSecure - provides excellent security & multi-layer 
user access for Paradox application forms & tables. 
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Port I/O on NT/95 


WinStar Hardware Classes 2 

Tk 

Hardware access library for Win32 
and VB4 applications. 

♦ C routines, C++ classes, and OCX 

♦ Port and physical memory access 

♦ Interrupt service routines 

♦ Supports both Windows 95 and NT 

♦ No DDK development required 

Other WinStar products... 

♦ Device Talk NT driver debugger 

♦ Kernel BASIC cross-platform driver 
development environment 



WinStar 


Technologies^ 

(415) 647-2815 

74367.1773@compuserve.com 


visit us at http://www wintech com 
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Bar Codes Can Be Fun. 
Honest! 

If you can change fonts, you can 
create bar codes. Code 128, Code 
59, UPC, and other symbologies. 

800 48-ASOFT 
206 932.6028 
info@azalea.com 
www.azalea.com 
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if there is nothing for me there. I did not 
believe you were so deluded to think 
that "the main roadblock to MFC 
becoming universal at this point is 
Microsoft." Maybe what should stop 
you from using MFC is that it is inferi¬ 
or and you already have something 
much better. Do you really believe for 
even one moment that MFC is better 
than OWL? Why don't you try to hon¬ 
estly use OWL before you go touting 
MFC? You might be in for a big surprise 
rather than act like another lemming 
following the rest of the mediocre 
crowd in embracing what is technically 
inferior. I hear this statement from peo¬ 
ple who have never used OWL but I 
did not expect it from you. 


Thanks for the editor feedback. On the 
other subject, as you are perhaps aware, 
many people have deep religious feelings 
about OWL, MFC, or both. I don't — I'm 
equally prejudiced against both of them. 
That being the case, since the reader letter 
I was answering did not ask about the rel¬ 
ative merits of OWL versus MFC, I did 
not try to offer any. The reader did ask 
specific questions about the long-term 
viability of MFC. I believe that my 
answers were mostly factual. Microsoft 
has licensed MFC to most Win32 C++ 
compilers, with the notable exception of 
Borland. The trade press has reported that 
only Microsoft's insistence that OWL be 
removed from the box keeps Borland from 
licensing and shipping MFC with their 


compiler. Thus, only Microsoft is keeping 
MFC from being included with virtually 
every Windows compiler. If MFC shipped 
in 99 percent of all Windows compiler 
boxes, I think that's a fair definition of 
"universal" in this context. If Borland is 
unafraid of this possibility, I'm not sure 
why any other OWL proponent should be. 
1 mainly avoid OWL and MFC because I 
want my code to work with most 
Windows compilers; if MFC gets added to 
Borland, that would remove my main 
objection to taking advantage of it. If this 
makes me a lemming, hopefully I am a 
factually correct lemming. I'm sorry to 
lose you as a subscriber, but thanks for the 
feedback. —rib 
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Marketplace™ 


Basic Scripting 


Cypress Enable 3.0 
Basic Scripting for Applications 

A powerful, complete, royalty free, VBA 
compatible, embeddable Basic Scripting 
Language. Cypress Enable Features: Royalty - 
free licensing, 60 day money back guarantee, 
OLE 2.0 Automation, Direct access to C++ 
objects, Dynamic Dialogs, Dialog Editor, 
Debugger (w/source). Named parameters. 
Easily extended, Printed & on-line 
Redistributable end-user documentation. Small 
footprint engine < 200K, Free tech support. 16 
bit S495; Mac, UNIX, DOS, Win 3.1, NT & 95. 
For whitepaper call: 1-800-790-4050. 



email cypress@cypressinc.com 
Fax:(602) 951-8047 www.cypressinc.com 
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•WinEdit 96- 


Edit huge text files. Automate weird 
compilers. $99.95 WinEdit comes with 
software for Windows 3.1,95 and NT on 
Intel, Mips, Alpha, and PowerPC. Get all 
the usual editor features, plus a 
massive, 447-function macro language 
for the ultimate in configurability. 


See for yourself. Download a free, 100% 
functional, evaluation copy, now. 


• For your full, free, eveI copy: 

Web: http://www.windowware.com 
FTP: ftp.windowware.com in /wwwftp/wilson 
CompuServe: WINAPA, Sec. 15 
BBS: 206-935-5198 

ir. 


Orders: 1-800-9384599 
or from our secure Web sewer 
Wilson WindowWare, Inc. 
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Win-Emacs 

The Complete Emacs Text Editor 
for Microsoft Windows® 


NEW! 32-bit version 
for NT/Win95/Win 3.1 


Win-Emacs™ is a full implementation 
of XEmacs 19.6—including e-lisp 
interpreter—for just $199 

To Order Call 1 -800-WIN-EMACS 


Pearl Software Corporation 

Tel: 510-652-4361 • Fax: 510-652-4362 
http://www.pearlsoft.com/ 
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Windows NT Drivers 


Development 

Consulting 

Training 

by the best in the industry 

• File Systems • Kernel Mode Drivers 

• NDIS Drivers • Systems Internals 



Open Systems Resources, Inc. 

105 Route 101A, Suite 19 

Amherst, NH 03031 

(603) 595-6500 — info@osr.com 


Call or email for a free no obligation quarterly subscription to 
The NT Insider , the world’s only newsletter dedicated entirely 
to Windows NT systems software development! 
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CDROMs! 


Official Slackware™ Linux - Slackware 3.0 (ELF) Linux, by author of 
Slackware. Easy install: learn Unix. XFree86 3.1.2, Td/Tk, GCC 
(2.7.0) compiler, Doom™. Works on 98% of PC's. 2 discs. $39.95 
Slackware subscription - convenient 3 month updates. $24.95 
FreeBSD® 2.1 - Berkeley BSD for PC. Solid Unix®-like, src, XFree86 
3.1.1, dev. tools, etc. (Subscription every 6 mo. $24.95) $39.95 
CUG Library - 10 years C/C++ Users'Journal src, listings. $49.95 
CICA® MS Windows - 5000 up-to-date shareware. 2 CDs. $29.95' 
Hobbes OS/2 Archived - 1000MB OS/2 apps, drivers. $29.95' 
Blackhawk 95 - 200 MB great Windows 95 applications. $29.95' 
Newt for NT - Windows NT app's, src, utils, GNU, drivers. $39.95' 
Simtel® MSD0S - Two disc set, classic MSDOS shareware. $29.95' 
Science Library - Technical, engineering shareware + book. $39.95' 
Perl - Source, binaries for many systems, documents. $39.95 
Math Solutions - Math programs, source code, docs. $39.95' 
POV-Ray - 3-D Raytracing: 1000 wow! images, src/binaries. $39.95 

’Shareware programs require separate payment to authors if found useful 

— Authors wanted. Please email discdev@cdrom.com — 


ORDER NOW! 1-800-786-9907 


Shipping is $5 in USA/Canada/Mexico, $9 Overseas per order 


ftlsl 



Walnut Creek CDROM 

* Suite D-693, 4041 Pike Lane, Concord CA 94520 
Phone: +1-510-674-0783 • FAX: +1-510-674-0821 • email:orders@cdrom.com 
All of our CDROMs are 100% unconditionally guaranteed! 

Call today for your free catalog of all our CDROM titles! i-1 

See these products free at http://www.cdrom.com/ Adcode: 693 
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Fax in DOS 


Async Professional for C/C++ lets you build 
powerful DOS async applications faster and easier. 
You getZmodem, 16550, DigiBoard, and Fossil 
support, Zip and Lzh, background execution, Class 
I, II, and CAS fax support, powerful comm debug¬ 
ging, and more. Two products in one- C & C++. 
Includes full source, documentation, free expert 
support by fax, e-mail, and phone, no royalties. 

Async Professional for C/C++, only $249. 

“/Wake no mistake, APro is the bestT 

Rick Ayre, PC Magazine, 4/28/92 

To order, or for Free info call 800-333-4160 

TurboPower Software P.O. Box 49009 
Colorado Springs, CO 80949-9009 
719-260-9136, fax 719-260-7151, CIS 76004,2611 
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g Lexicus Longha nd 

Handwriting Recognition Software 


Software Development Toolkit 

Use our new SDK for high user acceptance 
of your pen applications. Lexicus Longhand 
provides a fast and natural method of data 
input. With our SDK, the creation and 
prototyping of your pen-based applications 
has never been easier. The SDK includes: 

- Dictionary Building Tools 

- Custom VBX Controls 

- Documentation 

- Code Samples 

1-800-LEXICUS 

415-462-6800 

http://www.lexicus.mot.com 


(M) MOTOROLA 

Lexicus Division 


-i Request Reader Service #166 □ 


Add ZIP (and UNZIP too!) to 
your Windows applications! 


¥ DynaZIP 3 0 

1 Data Compression Toolkits 


The new ROYALTY-FREE DynaZIP family of 
developer's tools let you add ZIP and 
UNZIP capabilities to your Windows 
applications. No more "shelling" to 
DOS, no more fussing with proprietary 
compression formats. DLLs, VBXs, OCXs 
and a new database interface provide 
full access from many languages. Fast, 
reliable, and easy to use! 16 and 32 
bit versions, supports long filenames. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: (800] 962-2949 


Inner Media, Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
http ://www. innermedia .com 
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The best high 
performance, 
portable 
compression 
libraries for 


DOS, Windows, 
OS/2, Unix, 
Macintosh, 
embedded systems, 
and practically anything 
else, period. 


FREE DEMO 

DOS $249 
Win 16 $299 

Win32 $299 
OS/2 $349 
Unix $349 
Macintosh $299 

raj DC Micro 
Es Development 

Call 1-800 

info@dcmicro.com 


45-function API 
Buffer compression 
File compression 
Disk spanning 
Encryption 
Self-extracting EXE's 
VBX/OCX controls 
On-line help 
Full source code 

Tel 606-268-1559 
Fax 606-266-0726 

-775-1073 

http://www.dcmicro.com 
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Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&D jobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NT, Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
ana real-time, compilers, etc. Managed by 
graduate engineers. Send resume or call for a 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 
800-231-5920 Fax 800-757-9003 
http://www.scientific.com 

CompuServe: 71250,3001 AOL:davesmaU 
SP18, Box 19949. Houston. TX 77224 
713-496-6100 Fax:713-496-0373 
SPI8. Box 71. San Ramon, CA 94583 
510-733-6168 Beth @spica.bdt corn 
SPI8, P. O. Box 202676, Austin, TX 78720-2676 
512-260-0123 lej@zilker.net 

v___ 
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Web Page: http://www.bluewatersystems.com 


/ \ HASSLE FREE HARDWARE CONTROL 

©WinRT 


New Features: 
•Script 
Language 
■if-else 


■Arrays 
• Faster 
Execution! 
■Avg.15% 
speed 


Windows95'V 


Win32 8 

Binary Compatible 


*-NT" 


Spend your time writing your App...not 
wading through D.D.K. documentation! 
Fast hardware control under Win32® 
without the device driver kit! 

V Port I/O / Memory I/O V Interupts 
OCX version also available 


Ask us about Alpha™, PowerPC™ 4 MIPS versions 
NO RUNTIME ROYALTIES 


VISA, MC, AMEX & Approved P.O. accepted 
Tel (206)771-3610 * Fax (206)771-2742 
E-Mail: info@bluewatersystems.com 


(800)962-2114 
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C and C++ DOCUMENTATION 


!! VERSION 6.0!! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C 1 * 3 statements. 

• C-LIST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers. 

• C-DOC ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BROWSE Windows graphic-tree viewer, 

• C-DOC Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
0NT Canada L5N-4M1 http://swbs.idirect.com 


Please see Ad Index for our larger ad. 
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• Customize Code Generation for State 
Diagrams in almost any Language - Ada, 
VHDL, C, Delphi, Pascal, Smalltalk,more 

• Standard Scripts available for C, 
VHDL, C++, Pascal; Custom Reports 

• Template driven code for State, Class 
and Object Interaction Diagrams 

• Reverse Engineer C++, Delphi code 
32, 16 bit WITH CLASS starts at $295 
Call for FREE Eval: 908.668.4779 


MICROGOLD SOFTWARE. INC. 

76 Linda Lane Edison, NJ 08820 
_www.microgold.com_ 
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S/W ENGINEERING POSITIONS NATIONWIDE 



We Understand 
Programmers 
Mind. 8 " 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows, NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it’s time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


K Bateman Inc. 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 
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From: Neil Sandlin 
<neilsa@MICROSOFT.com> 

Subject: The "Windows" key 
Hi Ron, 

I didn't start using the Windows key 
until recently, when I discovered that 
you can just hit "Windows-E" (hold 
down the windows key and hit "e") to 
bring up a copy of the explorer. Also, 
"Windows-F" brings up the find 
applet, and "Windows-R" brings up 
the run dialog. Oh, and one more thing 
— "Windows-M" minimizes all win¬ 
dows, and "Windows-shift-M" restores 
them. Nice way to get to the desktop. 

I haven't found much use in hitting 
the Windows key alone. 

Okay, I have to admit that Windows-M 


and Windows-Shift-M is so handy that I 
now use them every day, and have learned to 
love my keyboard's Windows key. Thanks for 
the tip! Too bad I can't find a documented 
way to configure this stuff. —rib 


[From: Chee Wee 
<chuacw@singnet.com.sg> 

Subject: What baloney! 

Recently, I discovered that I was not 
sent WDJ from October or November 
1995 to April 1996.1 wrote to your com¬ 
pany and was subsequently sent the 
mags. I was so glad and satisfied with 
your company's handling of this matter 
that I decided to subscribe for the next 
5 years! Imagine my chagrin when the 
person who replied to me said that the 
company's database can only handle a 


maximum of three years of subscrip¬ 
tion!!! What sort of baloney is this? 

Well, I could not believe this was true, so 
I called the number myself and was less than 
pleased to discover that they indeed will not 
accept subscriptions for longer than three 
years. After investigating, this turns out to 
be one of those "that's the way the system 
works" situations that drive me up the wall. 
When Miller Freeman acquired us, our sub¬ 
scription fulfillment was moved out of house 
to a separate agency, and I am unfortunately 
still getting acquainted with the resulting 
new set of problems and Imitations. In the 
long term, we clearly need to get rid of the 
limitation, and I think we will be able to. In 
the short term, I apologize for this inconve¬ 
nience. Thanks for letting me know about 
this. —rib □ 



Developer's 

Marketplace™ 


C++ to HTML &rid 

RTF Documentation 

Object Outline extracts comments directly from source 
code. Requires no source changes or ugly comment tags. 
Combine external design documents, source code, and 
comments into a single, coherent, up-to-date document. 
Automatic hyper-linking. Integrate into an internal WWW 
project page. Works with all the major 32-bit Window compilers. 

Visit us on the web for a working demo and 
samples. Windows 95 and NT 3.51—$297. 

Order by calling 1-800-214-4746, 
fax an order to 1-800-657-8141 



More info: Web site www.bbeesoft.com, 
email info@bbeesoft.com, PO Box 541, Hudson, MA 01749 
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PROGRAMMERS... 
$100k/yr at HOME! 


My new book, "How To Make $100,000 A 
Year And More Developing Low Budget 
Software Products", will reveal all the 
marketing tricks, strategies, and systems that 
have my business exploding with PROFITS! 

Add your skills to my proven strategies and 
you have the PERFECT BUSINESS ... Low 
overhead, part-time, home-based, huge 
margins, and UNLIMITED POTENTIAL . 


CALL 800-364-4883 


Call TODAY for a FREE special report! 
ULTRA Fax: 214-724-0375 

Financial Syatams CompuServe: 71223,634 

1633 Arrowhead Dr, Flower Mound, TX 75028 
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www.dice.com 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-96(X) 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 
www.dice.com 


DATA PROCESSING 
I NDEPENDENT 

Consultant's i 

E XCHANGE k 

A Service of D&L Online, Inc:. (515) 280-1144 
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The Revolutionary Guide To 
MFC 4 Using Visual C+ + 



Mike Blaszczak 

ISBN 1-874416-92-3 
$49.95 

800 Pages + CD 


▲ Written by one of 
Microsoft's leading 
MFC developers 


▲ Updated for 

Visual C++ 4.0 and MFC 4.0 


. Explains the use of threads, exception handling 
and more 


a Covers Windows NT 3.51 and Windows 95 


▲ For more details visit Wrox Press Developer's 
Reference on the web at: 

http://www.wrox.com 



How To Order 

Phone.800-937-5557 Fax.800-PRI-ORDER 

Visa MC Amex DS Quote code CL58 for free freight 
For more information or a free color catalog of 
Wrox titles please call 800-USE-WROX 
or 312-465-3559. 
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Dr. DeeBee 
ODBC Tools 


Tools for ODBC development 

Ever wonder why 
your ODBC app is not 
working? Why it's just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 


□r. DeeBee ODBC Driver Kit 


Connect proprietary databases to 
Access, Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 




^SYI/WAEc - 

RO. Box 91 Kendall, Cambridge, MA 02142 
G17-497-137G Fax 617-497-8729 
http: //www. syware. com 
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| Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 22,000 
serious programmers in: 

Windows 

□ DEVELOPER'S JOURNAL 

The Magazine for Windows Programmers 


Call 913 - 841-1631 today for 

information about 
advertising opportunities in 
Windows Developer’s Journal. 


I breakout! marketing - Continental Europe. 

+49 431-801740 

I Ed - East I Christine - Midwest I Julie - West 
913-838-7547 1913-838-7546 1913-838-7541 



smoWb&sjc 


Demo / Tutorial / CBT / Presentation 
Visual Windows Automation 
Multimedia Authoring Development Kit 

Q Use ShowBasic Recorder io generate the editable, 
mouse/keyboard simulation code invariant to window's 
size and position, screen resolution and video driver. 

□ Achieve visual control over external applications 
and unlimited flexibility by programming in full 
featured Basic extended with the unique presentation 
and CBT related functionality, use even access to 
external DLLs and Windows™ 16-bit or 32-bit API. 

O Pack your application in a compressed executable 
with the small self-installed run-time and all supporting 
files (BMP. WMF. WAV. MIDI. AVI), compatible with 
Windows 3.1, Windows 95 and Windows NT . 

□ Deliver your titles transparently via WWW - 
ShowBasic can be integrated with any WEB browser. 

Development license $2<W with JO day money back guarantee. Royally free license SK05. 

If you don't need all the power of Show Basic - use our simple. 

yet flexible scripting language for live demos and automation: 

SnnnHELRttO -T^ TT - jr 

Single-user license $30 ($60 Pro). Royalty free license $300 ($300 Pro). Visa/MC accepted. 

Find more information, demos, samples and evaluation copy: 

http://www.cnj.digex.net/~mik 

■ MIKSoft, Inc. tel/fax: 908-390-8986 

37 Landsdowne Road. East Brunswick NJ. 08816 
Internet: mik@cnj.digex.net CompuServe: 74127,3671 
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Dept. 1205, 100 Park Avenue, Suite 360, Rockville, MD 20850 USA 
Int i: +1-301-424-3903 Fax:(301)762-8185 BBS: (301) 762-8184 

Copyright TeraTech 1995. Al rights reserved. Trademarks are the properly of their holders. 
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* Dazzle/VB - image manipulation. $199 

* VBIite - print/comm/array/B-Tree index.. $149 

* ProMath/VB - numerios/statistics. $149 

* FinLib/VB - financial calculations. $149 

* QuickLine/VB - telephony (multi-line) ...$495 

* SpellCheck/VB - spelling & lookup. $49 

* QB/C/dBase - 15 more DOS libraries ...$call 

* Custom - C, VB, ASM programming ... $80/h 

Develop your VB app taster: Get TeraTech 
tools! Call, E-mail or fax us and we'll mail you a 
free demo disk ASAP. Or for faster service 
download by FT P or from our BBS. Cal l now! 

800-447-9120 ext. 1205 


1 

ZIP 


XCEED ZIP 

COMPRESSION LIBRARY 


FOR VISUAL BASIC AND DELPHI 


Finally, a compression component that 
gives you your money's worth! Add 
Xceed Zip to your project, set a few 
properties, and your apps will be ziping 
and unziping in minutes. Great for 
automating backups, preparing files 
for transmission, or developing your 
own custom installer. 



( 800 ) 865-2626 
( 514 ) 442-2626 


Visit www.xceedsoft.com for a 
free trial version and find out 
why Xceed Zip is rapidly becoming 
the most popular VB and Delphi 
compression library! 
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K could be 

a best seller. 
But it's free. 

You can’t buy the Consumer 
Information Catalog. But you can 
get it, free! Send for your guide to 
over 200 free or low-cost government 
publications. Write: 

Consumer 
Information Center 
Department best, 
Pueblo, CO 81009 
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Opt-Tech Sort/Merge 


^ New-Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
Win95, OS/2, UNIX $249 
Call to order or for free info. 


Opt-Tech Data Processing 
P.O. Box 678 
Zephyr Cove, NV 89448 

l (702) 588-3737 j 
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L*. Cash in on 
£ the Voice 
1 —T Bonanza! 


Get your piece of the $3 billion Voice Industry - 
develop your own Computer Telephony Apps! 


Add voice power 
to your Windows 
apps with TI/F 
DLL ~ (CT Mag’s 
Product of the 
Year), our popular 
interface to 
Dialogic™ multi- 
line telephony 
hardware. 


Audio Too!Box" 
lets you batch 
process and 
convert audio files 
to & from standard 
formats. Adjust 
volume, filter, trim 
silence, more! Add 
to your apps with 
ToolBox SDK. 


Call and ask about 
our VFEdif 
professional voice 
prompt editor, 
Scribe™ trans¬ 
cription utility, 
VoxFonts ™ text- 
to-speech library, 
plus more great 
products! 



VISI, 2118 Wilshire Blvd, #973, Santa Monica, CA 90403 
310-392-8780 • Fax: 800-234-FXIT / 310-392-5511 sales@vinfo.com 
BBS: 310-392-6610 www.vinfo.com (Download Working Demos) 
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Market and 
Publish Software! 


WishBone Publishing, Inc. seeks software 
products to publish in the marketplace, 

If you have developed an innovative and 
creative game, program or utility, 
WishBone will review your program, 
determine its market potential, and 
publish the finished product. 

. WishBone 

PUBLISHING, INC. 

110117th Street, N.W., Suite 408 
Washington, D.C. 20036 

Telephone:202-331 -9789 
Toll Free: 800-982-2578 
Fax:202-872-0286 

http://www.wbonepub.com j 
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The Weekly MFC EXTension 


0 The only MFC extension class library that 
delivers new class(es) each week 
0 Updated through Internet e-mail 
0 Includes all classes available upon subscription 
0 Free sample classes available as demo 
0 Only $249 annual subscription 
0 Classes available include : Smart pointers and 
brilliant groups; GRID; MAPI; Dockable 
Property Sheet; JPEG compressor & decom¬ 
pressor; Extended Statusbar; OLE automation 
Server; Structured Exception Handling: 
Client/Server communication(includes JAVA 
client) and many, many more ... 

Now is the time to hire your 


most productive developer) 


at $249 a year !! 


Contact 
or visit 
Periphere 


Phone: 303-682-5297 
Fax: 303-772-9430 

eMail: info" perlphere.com 
http://w w w. peri ph e re .com 
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Track 

Bugs 

Down 



TRACK: Bugs • Features* Projects • Customer Calls 
• Much More! 

CUSTOMIZE: Reports • Queries • Forms and Fields 
NOTIFY: MSMail • cc:Mail • Lotus Notes • More 
INTEGRATE: PVCS • SourceSafe • Source Integrity 
LINK: Bugs with Support Calls • Projects • More 
ANALYZE: Trends • Process Improvements • 
Change History • More 


SOFFRONT® 


TM 




* 

i 

« i 
• • 

I I 
• • 

* I 
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What users say: 

“The ability to get users up and 
running with TRACK in a very 
short period of time is 
invaluable.” — G. Bryant, Principal 
Software Engineer, NEC Technologies, 
Inc. 

“We’re able to look at exactly 
what happened [on a project] and 
able to come up with accurate 
time estimates for future 
releases.” — Kirsten Thompson, Quality 
Assurance Analyst, Pepsi International 

“No other system offered the 
power, ease-of-use and flexibility 
to customize.”— C. Dziekan, QA 
Manager, Crystal Services. 


The Press Agrees: 

"TRACK automates interactions with 
related tools... in the course of solving 
the problem." — Peter Coffee. PC Week, 
March 4, 1996 

“TRACK wins hands down over the 
competition in the flexibility, power and 
ease-of-use areas.— Data Management 
Review, Jan 1996 

“Soffront's TRACK captures many of 
the best features of its competitors.” — 
Dave Duchesneau, Data Based Advisor, June 
1995 

“TRACK'S database and forms are so 
easy to modify... This program looked 
very flexible indeed.” — Kevin Weeks, 
Windows Tech Journal, Jan. / 995 


30-day, 

unconditional ^ 
money-back A 
guarantee 




-back A 
ntee^f 





1 - 800 - 763-3766 

SOFFRONT Software, Inc. Ph 408-263-2703 

238 S. Hillview Drive, Milpitas, CA 95035 • Fax 408-263-7452 
Internet: info@soffront.com http://www.soffront.com 
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Versions 

Available 



HIGH PERFORMANCE 


CONVERSION 


SCALE-TO-GRAY 


IMAGE PROCESSING 


THUMBNAILS 


PRINTING 


SCANNING 
FAST DISPLAY 


COMPRESSION 


and more! 


The Best Imaging Toolkit - Is Now Even Better! 


AccuSoft Corporation announces a totally new product, 
ImageGear," the next generation in imaging technology. 
ImageGear, the new version of the AccuSoft Image 
Format Library™, is more than just an upgrade, it is a 
whole new level of the quality and 
performance that has made AccuSoft the 
leading supplier of imaging toolkits. Just 
for starters, we redesigned all the image 
filters to add several new features to 
ensure that our support for image 
formats is by far the most comprehensive. We even 
added file-info executables for every format we 
support - and, of course, we added several new 
formats. 

ImageGear has a new and improved API that makes 
integration even easier, plus many new features 



including totally redesigned display functions for faster 
image display, sub-pixel accuracy, transparency, and an 
automatic image window with many built-in features. 
We also added new GUI functions including a 
comprehensive thumbnail browser, pan and 
zoom windows, magnifying glass, page 
sorter and more. All with complete 
programmability. We completely 
revamped the image processing to add 
dozens of new functions and better 
In addition, we have improved the 
scanning, image compression, display effects, and just 
about everything else! 

So get into high gear with ImageGear and remember - 
the best imaging toolkit makes the best applications - 

ImageGear 6.0! 


performance. 


You can start using 
1 AccuSoft products 
today by taking 

a a i a 1/ IT-/— advantage of our 
f*\l IvU I L~ unique 30 Minute 

Delivery 0e " Very Pr ° 9ram - 


Toll Free: (800) 525-3577 
Website: accusoft.com 


AccuSoft 

High Performance Imaging 


Two Westborough Business Park Westborough, Mfl 01581 Tel (508) 898-2770 FAX (508) 898-9662 

©1996 AccuSoft Corporation. All Rights Reserved All company and brand names are trademarks or registered trademarks of their respective owners.' 1. Raster only 2. License required from Unisys for formats using LZW compression. 3. Optional. 


Windows 
Win95\NT 
MIPS NT 
Alpha NT 
VBX 
OCX 
OS/2 
SUNOS 
Solaris 
HP-UX 
RS/6000 
SGI 
SCO 
MAC 

PowerMac 

Over 45 File 
Formats 

JPEG 
TIFF 
Group III 
Group IV 
PCX 
TGA 
PGM 
DIB 
IMT 
DCX 
BMP 
KFX 
RLE 
LV 

CALS 
ATT 
CLP 
XWD 
XBM 
CIF 
IFF 
SUN 
PNM 
IOCA 
GX2 
XPM 
ASCII 
CUT 
GEM 
BRK 
MAC 
PSD 
MSP 
• PNG 
PCD 
IMG 
IGF 
SGI 
ICO 
PBM 
PPM 
MO:DCA 
WMF 1 
WPG 1 
PICT 1 
EPS 1 
GIF 2 
ABIC 3 
JBIG 3 
DICOM 3 
and others 


i 



□ Request Reader Service #101 □ 


















#1 choice of expert 
Windows® developers! 


TAKE 
CONTROL! 



Announcing SoftlCE™ The Advanced Debugger For Windows NT 


New Softl CE for Windows NT allows you to experience more advanced debugging 
power, control and visibility than ever before! SoftlCE works behind the scenes with its 
On-Demand Debugging " letting you hot key into the system at any time. Absolute system 
wide control and visibility features give you access to the vital system state information 
you need to solve tough problems. 


Use Softl CE to: 


■ Perform multi-process, multi-thread 
debugging 

■ Perform non-intrusive, kernel-mode device 
driver debugging on a single machine 

■ Debug all system modules 

■ Debug all Win32 and Win 16 
applications and DLLs 

■ Debug all DOS programs, including 
DOS extender applications 


■ Use advanced software and hardware 
breakpoints with conditional expressions 

■ Use the powerful system-wide object 
search and identification facility 

■ Perform exhaustive heap validation 
diagnostic 

■ Debug remotely over dial-up connection 

■ Monitor events system-wide 

■ Learn Windows NT internals 


Take control today, get SoftlCE for Windows NT 
The Advanced Windows Debugger 

Call T -800-4-NUMEGA 

(1-800-468-6342) 

Or Order Through Our Web Site ... 

www.numega.com 


$ 6 * 9 !' 


603 889-2386 • 800 4-NUMEGA • Fax 60? 889-1 135 •info@numega.com • www.numega.com 
NuMega Technologies, the NuMega logo, SoftlCE, the So/fICE logo, and On-Demartdl)ebugging are trademaHfc£~of NuMega Technologies. 

All other trademarks are the property of their respective owners. CopyrighTOl 996. ^Pwghts reserved. 


NuMega 

Technologies 
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